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إهداء 


أهدي هذا العمل المتواضع إلى والدتي العزيزة ووالدي رحمه الله والذين كانا خير داعمين لي في مسيرتي العلمية 
كما أهدي هذا العمل إلى عائلتي الصغيرة: زوجتي وإبنائي لصبرهم على انشغالي عنهم ودعمهم لي لإنجاز هذا 
اسل 
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مقدمة الكتاب 


في ظل التزايد المضطرد في استخدام الهواتف الذكية والأجهزة اللوحيةء تعتبر تطبيقات الهواتف الذكية من 
أكثر البرمجيات التي يتطلبها سوق العمل في مجال تكنولوجيا المعلومات. على الرغم من وجود العديد من المراجع 
والكتب المتخصصة في تعليم برمجة تطبيقات الهواتف الذكية» إلا أن معظم هذه المراجع معدة باللغة الإنجليزية 
وتستهدف المطورين الذين يتقنون اللغة الانجليزية» حيث لايزال هناك قصور كبير في المراجع العربية في هذا 
المجال. يعتبر هذا العمل المتواضع من أوائل الأعمال التي تتناول تطوير تطبيقات الهواتف الذكية باستخدام نظام 
أندرويد. كما أنه من أوائل الأعمال الموجهة أكاديمياً وذلك ضمن تخصص تطوير تطبيقات الهواتف الذكية في الكلية 
الجامعية للعلوم التطبيقية - غزة. 


هذا الاب هر المزجع الركيس لمضاق تطوير تطبيقات: الهوائف النكية 1 حيبت تعمد دراسة هذا الاق على 
متطلبين سابقين هما: أساسيات البرمجة والبرمجية الشيئية (ع منص ”02ء۴ )0bject Oriented‏ وكذلك تصميم 
واجهات الهواتف النقالة. لذلك فإن هذا الكتاب لايغطي مبادئ البرمجة الشيئية التي يجب أن يكون الطالب ملماً بها. 
كذلك لن يتم التطرق في هذا الكتاب إلى الطرق المختلفة لتصميم الواجهات (1,230015) باستخدام 23/11» حيث 
سيتم التركيز على التعامل مع عناصر واجهة المستخدم برمجياً فقط. كذلك يجب أن يكون لدا الطالب معرفة بمفهوم 


يراعي الكتاب في تقديمه وعرضه الإحتياجات الأكاديمية وذلك بالدمج ما بين المفاهيم النظرية التي يجب أن 
يلم بها الطالب بالإضافة إلى الجانب العملي الذي يتم تنميته من خلال عدد كبير من الأمثلة والتمارين. يحتوي 
الكتاب على عشر وحدات تغطي المواضيع الأساسية التي يتطلبها المطور المبتدئ. كذلك يحتوي الكتاب في وحداته 
العشر على أكثر من عشرين تمرين عملي محلول معدة من قبل مؤلف الكتاب و مفصلة خطوةً بخطوة. تهدف هذه 
التمارين إلى تدريب الطالب على بناء تطبيقات متكاملة تغطي مختلف المواضيع التي يتناولها الكتاب. كذلك تحتوي 
كل وحدة في نهايتها على عدد من الأسئلة للتقييم الذاتي. 
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3 الوحدة الأولى (الفعالية - 10 ناءم)‎ ٠ 
12 (Application Structure — ه الوحدة الثانية (بنية التطبيق‎ 


ه الوحدة الثالثة (التعامل مع عناصر الواجهة برمجياً — Interacting with UI Components‏ 
(Programmatically‏ 27 


ه الوحدة الرابعة (الربط بين الفعاليات باستخدام الأهداف - (Linking Activities Using Intents‏ 


53 

ه الوحدة الخامسة (القوائم وشريط العمل — (Menus and Action Bar‏ 74 

ه الوحدة السادسة (استدامة البيانات في نظام أندرويد - (Data Persistence in Android‏ 94 

رقم الصفحة 

ه الوحدة السابعة (مزودات المحتوى — (Content Providers‏ 134 
ه الوحدة الثامنة (مستقبلات النشر - (Broadcast Receivers‏ 146 
ه الوحدة التاسعة (القطع — (Fragments‏ 164 
ه الوحدة العاشرة (نشر تطبيقات أندرويد — (Publishing Android Applications‏ 198 
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التراجم 


ترجمة المصطلحات التقنية المتعقلة بالبرمجة الشيئية ونظام أندرويد كان من الصعوبات التي واجهت المؤلف في 
إخراج الكتاب. لشرح المصطلحات التقنية باللغة العربية بدون الإخلال بمفاهيم هذه المصطلحات قمنا بترجمة 
المصطلحات إلى العربية وقمنا أثناء الشرح بذكر الترجمة العربية ملحوقة بالمصطلح الإنجليزي بين قوسين. 
التراجم المستخدمة للمصطلحات المختلفة موضحة في الجدول التالي. نود التأكيد على أن بعض المصطلحات لم 
تترجم حرفياً حيث تم الاعتماد أحياناً على تراجم قريبة لكونها أقرب للمفهوم الفعلي من الترجمة الحرفية من وجهة 
نظر المؤلف. 


من الضروري أيضاً أن نؤكد على أن ترجمة المصطلحات هي بغرض مساعدة القارئ العربي على فهم السياق 


وليس لاستبدال المصطلحات الأصلية بالتراجم العربية. لذلك نوصي كلا من المدرس والطالب بالحرص على 
استعمال المصطلح الإنجليزي قدر الإمكان. 


المصطلح الترجمة المستخدمة في الكتاب 
Activity‏ الفعالية 
Service‏ الخدمة 
Broadcast Receivent‏ مستقبل النشر 
Manifest File‏ ملف الوثيقة 
Layout File‏ ملف التصميم 
Assets Folder‏ مجلد الممتلكات 
Activity Lifecycle‏ دورة حياة الفعالية 
Backstack‏ الحافظة الخلفية 
Intent‏ الهدف 
PendingIntent‏ الهدف المعلق 
Explicit Intent‏ الهدف الصريح 
Implicit Intent‏ الهدف المضمن 
Intent Filter‏ مرشح الهدف 
Action‏ حدث أو إجراء 
Class‏ فئة 
Subclass‏ فئة فر عية 
Superclass‏ فئة رئيسية 
Interface‏ الواجهة البرمجية 
Object‏ كائن 
Method‏ دالة 
Callback Method‏ دالة الاتصال الراجع 
Constructor‏ البانى 
Package‏ حزمة 
Listener‏ مستمع 
Adapter‏ محول 


عنوان الكتاب 


رقم المقرر 


ListView 
Shared Preferences 
Bundle 
OptionsMenu 
Context Menu 
Popup Menu 
Menultem 
Action Bar 
Action Overflow 
Navigation Drawer 
XML Attribute 
Permission 
Notification 
Notification Drawer 
Content Provider 
Content Resolver 
Fragment 
Fragment Manager 
Dialog 
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قائمة العرض 
التفضيلات المشتركة 
الحزمة 
قائمة الخيارات 
قائمة السياق 
القائمة المنبثقة 
شريط العمل 
ملحق شريط العمل 
درج التصفح 
خاصية XML‏ 
إذن 
إشعار 
درج الإشعارات 
مزود المحتوى 
مستخرج المحتوى 
القطعة 
مدير القطع 
مربع الحوار 
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الوحدة الأولى: 
الفعالية (46115107) 


يتعلم الطالب في هذه الوحدة: 
> . مفهوم الفعالية (411717) في نظام أندرويد وطريقة إنشائها. 
> . دورة حياة الفعالية (41717) وطريقة إدارتها بصورة سليمة. 
”ا . حفظ حالة الفعالية (/]410171) واستردادها. 
> التعريف بأوضاع العمل الخاصة بالفعالية (7و4119716) واستخدام الحافظة الخلفية 56210 ع1[ع182). 
مد ب قرت اسل على فا اة وروا مع هاا اة 


هناك أنواع مختلفة من المكونات يمكن أن يبنى منها تطبيق الأندرويد. أول هذه المكونات يسمى بالفعالية 
(405119) وهي جزء من تطبيق أندرويد يوفر للمستخدم واجهة تفاعلية تمكنه من تنفيذ أمر ما مثل تصفح 
الأخبارء البحث عن معلومةء الاتصال الهاتفي» التقاط الصور» عرض خريطة أو أي مهمة أخرى. كل فعالية 
(Activity)‏ تمثل نافذة مستقلة في التطبيق. هذه النافذة قد تعرض في وضع ملء الشاشة أو قد تحتل جزء صعغير 
من الشاشة. 


تطبيق الأندرويد يتكون عادة من مجموعة من الفعاليات (48171165) الغير مرتطبة ببعضها. كل تطبيق له عادة 
فعالية رئيسية واحدة (420171 «نةN1)‏ وهي التي تعرض على الشاشة عن تشغيل التطبيق. بعد تشغيل الفعالية 
الرئيسية (/(]61171, «نة۷1) » يمكن من خلالها تشغيل فعاليات أخرى لتنفيذ مهمات مختلفة. على سبيل المثال» عند 
تشغيل تطبيق إخباري لأول مرة يتم عرض قائمة الأخبار في الواجهة الخاصة بالفعالية الرئيسية 30ة/73) 
(711]عخء وعند اختيار أي خبر محدد بالنقر عليه» يتم تشغيل فعالية جديدة لعرض تفاصيل الخبر. 

واجهة المستخدم يتم عادةً إنشاؤها وتصميمها من خلال ملفات 11× كما درست مسبقاً. الفعالية (/و4.019710) تقوم 
عند بدء تشغيلها بإنشاء الواجهة بناءَ على محتوى ملف ,75711. في ملف الفعالية (40171097) يتم كتابة كود يمثل 
الأجراءات المختلفة الى يجت فيذها عند تفاعل السنقحدع مع عاص الواجهة ويذلك بكرن هناك قصل كامل بين 
تصميم الوانجهات» والذي يكم من .خلال لفات ا :والإجراءات اللازم تتفيذهاء والكى يكم تخديدها داخل الفعالية 


.(Activity) 
سيتم شرح كيفية إنشاء‎ ٠01 18317145 قبل الحديث عن التعامل مع واجهة المستخدم والتفاعل مع الأحداث المختلفة‎ 
الفعالية (رزل1)ءA) وإدارتها.‎ 


(Creating the Activity) إنشاء الفعالية‎ 


لإنشاء فعالية جديدة» يجب عليك إنشاء فئة فرعية (sوهاءطاسء)‏ من الفئة (4051697) أو أي فئة متفرعة من 
20117 ). بعد ذلك عليك كتابة الكود الخاص بدوال الاتصال الراجع (ئلمطاء× عاع031153). دوال الاتصال 
الراجع هي دوال. يتم تنفيذهنا ثلقائيا من قبل النظام (يدون تدخل. المستخدم) يناء. على الكغير في دورة حياة الفعالية 
.(Activity Life Cycle)‏ 
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فمثلاً عند بدء تشغيل الفعالية يقوم النظام بتشغيل الدالة (02076366)0» وعند إزالة الفعالية (/400536) يتم تشغيل 

الدالة ()/001(65003. يمكن للمستخدم تنفيذ أي كود عند بدء تشغيل الفعالية (77إ42101716) عن طريقة إضافة هذا 

الكود إلى الدالة ()02006266. فمثلاًء نقوم عادة بكتابة الكود الخاص بإنشاء محتويات واجهة المستخدم داخل الدالة 

00016260 وذلك لتجهيز الواجهة للعرض عن بداية تشغيل الفعالية (/إ]81193). أهم الدوال التي نحتاج عادة 

إلى إضافة كود لها عند إنشاء الفعالية (رإازA)]۷)‏ هي: 

ه (19]6)0)من: يجب كتابة الكود الخاص بهذه الدالة والتي ينفذها النظام تلقائياً عند إنشاء الفعالية. نقوم عادةٌ في 
هذه الدالة بثهيأة وانشاء المكونات المخثلفة الخاصة بالفعالية. من خلال هذه الدالة يتم تحديد هيكلية الواجهة 
الخاصة بالفعالية عن طريق استدعاء الدالة ()56])0021662]59/1618. نقوم عادة بتحديد معرف خاص بملف 
31 الخاص بالواجهة وتمريره إلى الدالة .setConten{View()‏ 

»ه ()11116و00196: يتم تنفيذ هذه الدالة عندما تصبح الفعالية مشاهدة visible‏ وذلك بعد إنشائها أو اسئناف عملها 
بعد توقف. أي أن هذه الدالة يتم تنفيذها بعد الدالة .onCreate()‏ قد 3 تستخدم هذه الدالة لاسترجاع حالة الفعالية أو 
لربطها بمكونات التطبيق الأخرى مثل الخدمات (وع710ت1ع5). 


® ()ع02223115: يقوم النظام باستدعاء هذه الدالة تلقائياً عند ايقاف الفعالية. إيقاف الفعالية قد يكون نتيجة تشغيل 


فا ارىئ تيا را عن الغا ولا بتي والصترورة إنهاء الفعالية أو إخفائها. نحتاج إلى كتابة هذه 
الدالة لحفظ حالة الفعالية والبيانات التي تستخدمها حتى لا تفقدء وحتى يتم استعادتها عن الرجوع للفعالية. 


ه (0)م9]0من: يتم تنفيذ هذه الدالة عندما تصبح الفعالية غير مشاهدة تماماً. يمكن استخدام هذه الدالة لإيقاف 
العمليات التي تنفذها الفعالية. 

هناك المزيد من دوال الاتصال الراجع (216]5005 0211801) والتي سيتم التطرق لها عند الحديث عن دورة 

حياة الفعالية (©9/01© عا 1019 ,ى) لاحقاً في هذه الوحدة. 

الإعلان عن الفعالية في ملف القائمة )وع1/1211 

بعد إنشاء الفئة (class)‏ الخاصة بالفعالية» يجب الاعلان عن الفعالية في ملف الوثيقة 16و713111. ملف الوثيقة 

Manifest‏ يحدد الإعدادات المختلفة للتطبيق والمكونات التي يستخدمها وسيتم شرحه في الوحدة الثانية من هذا 

الكتاب. الإعلان عن فعالية ما (ر)زنامA)‏ يتم عن طريق إضافة الخاصية </200710> داخل الخاصية 

<1162102مم3> كما هو موضح في الكود التالي ( ملاحظة: قد تقوم بيئة العمل مثل 56م11ع1 بعمل ذلك تلقائيا): 


smam ir 35025 ©: 
42155212656 كت‎ sos 
<activity android:name=".ExampleActivity" /> 


ooo 3‏ ث6 تت مم CJ‏ 


2311116831 
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هناك أيضاً بعض الخصائص التي تضاف داخل المكون <21107197> والخاصة بالفعالية مثل اسم الفعالية 
:na me‏ والذي يجب اضافتها لتحديد اسم الفئة (ووه1ء) الخاص بالفعالية. 


(Managing the Activity Life Cycle) إدارة دورة حياة الفعالية‎ 


إدارة دورة حياة الفعالية (Activity)‏ عن طريق كتابة الكود الخاص بدوال الاتصال الراجع (Callback‏ 
(sل0طMet‏ إجراء مهم لبناء تطبيق صحيح. دورة حياة الفعالية (رازاناءA)‏ تتأثر مباشرةً بارتباطها بالفعاليات 
الأخرى. الفعالية يمكن أن تكون في حالة من ثلاثة حالات: 


ه وضع العمل :running‏ وفي هذه الحالة تكون الواجهة في المقدمة ومفعلة من قبل المستخدم. 


ه وضع الإيقاف المؤقت 4عوںهم: تنتقل فعالية ما إلى وضع 0310560 عندما يتم تشغيل فعالية أخرى تنتقل إلى 
الواجهة وتكون هذه الفعالية الجديدة شفافة جزئياً أو لا تملأ الشاشة بحيث لا يزال بالإمكان رؤية الفعالية 
الأولى. الفعالية في وضع الإيقاف المؤقت تظل الفعالية في الذاكرة وتحتفظ بحالتها وقيم المتغيرات فيهاء ولكن 
قد يلجأ النظام لتدميرها في حالة القصور الشديد في الذاكرة. 


وه وضع الإيقاف :stopped‏ تنتقل الفعالية إل هذه الحالة عندما تصبح غير مشاهدة تماماً ويتم حجبها خلف فعالية 
أخرى (أي أنها تصبح في المؤخرة). الفعالية في وضع الايقاف تحتفظ كذلك بحالتها وقيم المتغيرات فيهاء ولكن 
قد يلجأ النظام لتدميرها في حالة القصور الشديد في الذاكرة. 


عندما تنتقل الفعالية من حالة إلى أخرى من الحالات الموضحة أعلاه» يتم إعلام الفعالية من قبل النظام عن طريق 
تشغيل دوال الاتصال الراجع (sل0طاءM‏ ع31156361©) الملائمة حسب الحالة. لذلك» يمكن كتابة كود في هذه 
الدوال لتنفيذ مهام محددة عندما تتغير حالة الفعالية. الكود الموضح بالأسفل يوضح هيكلية الفعالية وأهم دوال 
الاتصال llرlIجMethods)g :(Callback‏ 


| ل AOE‏ 5ت 6 EY CX‏ لد عات كت 511 ته BUBBLE CLASS‏ 
@GOverride‏ 
public void onCreate (Bundle savedInstanceState) {‏ 
م super.onCreate (savedInstanceState)‏ 
. الفعالية في مرحلة الانشاء // 
} 
@GOverride‏ 
DEO 225 556 MOMS OMSEAEE )( ]‏ 
COR SIE AEE )(‏ عت 5115 
. الفعالية على وشك أن تصبح مشاهدة. تنفذ هذه الدالة قبل العرض مباشرة // 
/ 
@GOverride‏ 
protected void onResume () {‏ 
super.onResume () ;‏ 
تنفذ هذه الدالة بعد ان تصبح الدالة مشاهدة / / 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


GOverride 


protected void onPause )( {‏ 
م () super.onPause‏ 
تنفذ هذه الدالة عن ايقاف الفعالية مؤقتا بسبب تشغيل فعالية أخرى / / 
/ 
@GOverride‏ 
DEO 256656 VOM OMSEOS O f‏ 
م () super.onStop‏ 
الفعالية غير مشاهدة تماما وعليه تم ايقافها وتنفيذ هذه الدالة / / 
/ 
@GOverride‏ 
ONA OMDeES EEO )( !‏ 5226© طشك 
super.onDestroy )( ;‏ 
تنفذ هذه الدالة قبل تدمير الفعالية مباشرةً / / 


ملاحظة: اذا أردت كتابة أي كود في دوال الاتصال الراجع فعليك أولاً تنفيذ دوال الاتصال الراجع في الفئة الأم 
(6118355م511) وذلك قبل تنفيذ أي كود جديد كما هو موضح بالشكل. فمثلاّء في الدالة (0001262]6)0 يتم تنفيذ الدالة 


re2)‏ uper.onء‏ ثم يتم كتابة بقية الكود. 


دورة حياة الفعالية كاملةة موضحة بالشكل 1-1 بالأسفل حيث تمثل المستطيلات دوال الاتصال الراجع ( 2111© 
«(Methods‏ وتمثل الدوائر حالات الفعالية. دورة حياة الفعالية تحصل ما بين تنفيذ الدالة onCreate()‏ والدالة 
(0إ00106510. لذلك» كل ما يرتبط بإنشاء الفعالية من إنشاء هيكلية واجهة المستخدم والمتغيرات وتهيئة حالة 
الفعالية والاتصال بقواعد البيانات مثلا يتم في الدالة .onCreate)‏ کل ماهو مرتبط بانهاء حالة الفعالية من اغلاق 
الاتصال بالخدمات أو قواعد البيانات يمكن أن يتم في الدالة .onDestroy()‏ 


هناك ما يسمى دورة الحياة المشاهدة للفعالية ع1عل9ع116 577151616 وتحصل ما بين الدالة ()00516211 و 
onStopO‏ وخلالها تكون الفعالية مشاهدة من قبل المستخدم. لاحظ أن دورة الحياة المشاهدة هي جزء من دورة 
الحياة الكاملة. لاحظ أن الفعالية المشاهدة قد لا تكون بالضرورة في وضع العمل running‏ (قد تكون في وضع 
الايقاف الموقت نتيجة تشغيل فعالية تحجبها جزنيا). 


وهناك أيضا دورة الحياة في المقدمة ع1علزء1116 أ«uهإعءإه۴‏ وهي جزء من الدورتين السابقتين وتحصل بين 
تنفيذ الدالة ()عصuءعRمه‏ والدالة ()ءونجمه. خلال هذه الفترة تكون الفعالية في وضع العمل ع11011» أي 
أنها تكون مشاهدة ويتم التفاعل معها من قبل المستخدم. لاحظ أن الكود الذي يتم كتابتة في الدالة () 02196510126 و 
الدالة onPause()‏ یتم تنفيذه عندما يحصل أي تغيير في حالة الفعالية» ولذلك تستخدم هذه الدوال بكثرة لحفظ حالة 
الفعالية والبيانات المتعلقة بها عند حصول أي تغيير في حالة الفعالية. 


صفحة. 6 


SS‏ اه عنوان الكتاب 
رقم المقرر 


onCreate() 


0 


onStart() م‎ onRestart() 


onResume() 


User navigates 
to the activity 


Another activity comes المستخدم يغود للفعالية‎ 


into the foreground 


User returns‏ اا هة 
to the activity‏ ية اخری جاءت إلى 


Apps with higher priority 
need memory | onPause() 
تطبيق له أولوية إبحاجة إلى ذاكرة‎ 
The activity is المستخدم تصفح إلى الفعالية‎ 


no longer visible 
الفعالية عير مركية‎ User navigates 
عجر‎ to the activity 


onStop() لاطا‎ 


' 
The activity is finishing or ١ الفعالية قيد الإنهاء أو‎ 
being destroyed by the system ١ التدمير من النظام‎ 


1 


| onDestroy() 
لات‎ 


شكل 1-1: دورة حياة الفعالية Activity Life Cycle)‏ 1 


في كل مرة يتم فيها تشغيل فعالية جديدةء يتم ايقاف الفعالية السابقة. يقوم نظام الأندرويد بحفظ وترتيب الفعاليات في 
حافظة خلفية تسمى )عه)؟ 231 كما هو موضح في شكل 1-2. كل فعالية جديدة يتم تشغيلها يتم إضافتها إلى 
مقدمة الحافظة ليها الفماليات السابقة. الفعالية و اع الث في مقدمة الحافظة هي فقط تكون في وضبء 
التشغيل ع010مدمء بينما تكون كل الفعاليات التالية لها متوقفة عن العمل. عند إنهاء الفعالية التي في المقدمة عن 
طريق النقر على زر 8301 يتم إيقافها وإزالتها من الحافظة» وتصبح الفعالية التالية لها في مقدمة الحافظة الخلفية 


Activity, Android Developer, http://developer.android.com/reference/android/app/Activity.html .' 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


لتنتقل إلى وضع التشغيل. بالرجوع إلى مثال التطبيق الإخباري» عن تفعيل الفعالية الخاصة بأي خبر تنتقل هذه 
الفعالية إلى مقدمة الحافظة الخلفية» وتتوقف الفعالية الرئيسية عن العمل لتصبح في مؤخرة الحافظة الخلفية. عند 
انتهاء المستخدم من استخدام الفعالية الفرعية والنقر على زر ع1ع82» يتم ازالة الفعالية من الحافظة لتعود الفعالية 
الرئيسية للواجهة وتصبح في بداية الحافظة. 


< بس دح موتو > ا« دده نه له‎ < GG Onu 
Rony | Start Actlvty 2| Activity [Start Activity 3 3 [Start Acuity 4| Start [Start Activity 3 3 
عا‎ key 


Back Stack 
الحافظة الخلفية‎ 


[awı 1 


Root activity for the task 
الفعالية الأولى في المهمة‎ 
Running Activity 


شكل 1-2: استخدام الحافظة الخلفية (ع[ع512 8k‏ 1 


يهدف هذا التمرين إلى تتبع دورة حياة الفعالية (Activity Life Cycle)‏ والتسلسل المستخدم في تنفيذ دوال 
الاتصال الراجع (21615005 ع02115301). سنقوم في هذا التمرين بإنشاء فعالية بدون أي عناصر في واجهة» ومن 
ثم سنكتب كود طباعة في بعض دوال الاتصال الراجع. كود الفعالية موضح بالأسفل: 


Destroyed activity 


BHO لل‎ 165 CLASS MIRAGE EY CESECERAS AEE EY 


@GOverride 

protected void onCreate (Bundle savedInstanceState) { 
5 16 تلت‎ : ONCE Ee (Save IRS EAREEeS Ea Ee ) 
Toast.makeText (this, "onCreate™", 

Toast. LENGTH _ SHORT) .show() م‎ 

} 

@GOverride 

BEOEC CECA UO 22056 )( | 


Android for ‘Starters’, http://techiezjunkyard-android.blogspot.com/2012/01/task-and-back- ' 
stack _ 8919.html 
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super.onPause )( م‎ 
Toast .makelext (EMIS, ONEaUSeL, 
Toast. LENGTH _ SHORT) .show() م‎ 
/ 
06 ع0 221ع017‎ 
protected void onResume () 1 
super.onResume () ; 
Toast.makeText (this, "onResume™", 
Toast. LENGTH SHORT) .show(); 
/ 
GOverride 
2ه لكر‎ 256556 MONE OMS EOE O 
SUPeE . ORS EOP )( : 
TOA S Ema Ke Mee (ERM SY, ONSEN, 
Toast. LENGTH SHORT) .show(); 
/ 
GOverride 
كلدم 6ت 2565© عكر‎ OMBDeS ELOY O 
super.onDestroy )( ; 
11265955 Ema Kelex EKERTLS, OnNDeS EEO, 
Toast. LENGTH _ SHORT) .show() م‎ 
/ 
/ 
قم بتشغيل التطبيق وتتبع ترتيب الرسائل التي يتم طباعتها.‎ 


بعد إكتمال تشعيل الفعالية وتوقف طباعة الرسائل» إنقر على زر 189301 لانهاء الفعاليةء ولاحظ تسلسل الرسائل 
التي يتم طباعتها في هذه الحالة. 


ملاحظة. لإنشاء رسالة ليتم طباعتها على الشاشة يمكن استخدام الدالة .Toast.makeText)‏ هذه الدالة يمرر لها 
كائن من نوع ٥٥,»‏ وهو يمثل التطبيق الحالي ويمكن تمرير الفعالية الحالية. كما يمرر لها الرسالة المراد 


طباعتها ومدة العرض ( Toast. LENGTH_SHORT‏ أو .)"ast.LENGTH_LONG‏ بعد إنشاء الرسالة 
يتم طباعتها بتنفيذ الدالة ()102356.51019. طباعة رسائل من نوع 10356 سيتم استخدامه بكثرة في التمارين 
المذكورة في هذا الكتاب. 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


حفظ حال العا 


ذكرنا مسبقاً أن الفعالية (رز)ءA)‏ في حالة الإيقاف لعممه)ء أو الإيقاف المؤقت 0560م يتم الإحتفاظ بحالتها 
ولا تفقد المعلومات الخاصة بها مثل حالة واجهة المستخدم ولذلك لأن الفعالية ما تزال في الذاكرة. ولكن عند إنهاء 
الفعالية من القبل النظام يتم أزالتها من الذاكرة وتفقد كل المعلومات الخاصة بها. عند الحاجة إلى تشغيل الفعالية مرة 
أخرى يقوم النظام بإنشاء نسخة جديدة من الفعالية. المستخدم يجب أن لا يلاحظ أن النظام قام بتدمير الفعالية السابقة 
وأنشاء أخرى جديدة» ولذلك يتوقع أن تحتفظ الفعالية بحالتها وبياناتها. ولذلك يجب على المبرمج أن يحرص على 
حفظ حالة الفعالية قبل تدميرها اذا كانت هناك حاجة لتشغيل الفعالية في وقت لاحق. 


هناك أك من طريفة الفط سالك الفعالية والبيانات: النتطلقة .نيا يكن ارمح استفذاء. .الدالة 
te0‏ n5avenstanceStaه»‏ والتي يقوم النظام تلقائياً بتنفيذها مباشرة قبل إيقاف الفعالية. يمرر النظام لهذه الدالة 
حزمة 2812016 وهي عبارة عن حافظة يمكن تخزين بيانات بداخلها عن طريق دوال إدخال مخصصة مثل 
nt0آutم‏ و 0عStrin{ام.‏ بعد تدمير الفعالية تظل كل البيانات المخزنة في الحزمة 2812016 حتى يحتاج 
المستخدم إلى تشغيل الفعالية مرة أخرى. عندهاء يقوم النظام بإنشاء نسخة جديدة من الفعالية ويقوم بتمرير الحزمة 
Bundle‏ إلى الدوال onCreate()‏ و )nRestoreInstanceStateە.‏ باستخدام أي من هاتين الدالتين» يمكن 
استخراج الحالة والبيانات المحفوظة في الحزمة 812016. إذا لم يكن هناك أن بيانات لاسترجاعها (كما في حالة 
تشغيل الفعالية لأول مرة)» تكون قيمة الحزمة 183016 هي 11111. 


الكود التالي يوضح الدوال onSaveInstanceState()‏ و onRestoreInstanceState)‏ وكيفية التعامل مع 
الحزمة Bundle‏ لحفظ واسترجاع البيانات» حيث يتم كتابة هذا الكود داخل الفعالية :(Activity)‏ 


@GOverride 
protected void onSavelnstanceState (Bundle outState) { 
super.onSaveInstanceState (outState) م‎ 
OME SIE AEE PUES للك طعا‎ (Username, 595121262135 UCAS : :11ت‎ ESL); 
} 
@GOverride 
protected void onRestorelInstanceState (Bundle 
savedInstanceState) { 
SUPE. تلت عت 6 5 3 جه‎ SEANCES 2 2 155 (SAVER SIE SRE E SEA EE) 
56ت‎ 1150 521252105 > 
savedInstanceState.getString ("username"); 


} 


يجب الملاحظة أن حالة العناصر الموجودة في واجهة المستخدم وأمعل¡W‏ 171 مثل القيم الموجودة في ×ع ٤1۲۲‏ 
و ×80 )عط يتم حفظها في الحزمة 1110016 واسترجاعها تلقائياً عند إعادة إنشاء الفعالية دون الحاجة إلى كتابة 
كود للقيام بذلك. كل ما على المبرج القيام به ليضمن الحفظ التلقائي لحالة عناصر واجهة المستخدم هو إعطاء اسم 
معرف غير مكرر لكل عنصر وذلك باستخدام الخاصية 3201010:10 في ملف التصميم ]23'011.آ. 
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الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
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على الرغم من أن حالة عناصر الواجهة يتم حفظها تلقائياًء يمكن استخدام الدالة ()]005256105]8066512 لحفظ 
بيانات أخرى مثل قيم المتغيرات والمصفوفات. 

ملاحظة: ليس هناك ضمانة أن يتم تنفيذ الدالة ()ع02592761256820651426 من قبل النظام قبل تدمير الفعالية (كماً 
في حالة أن يقوع المستخدم بإنهاء الفعالية بالنقر على زر وء لذلك ينصح باستخدام هذه الدالة لكتابة الكود 
الخاص بحفظ حالة واجهة المستخدم فقطء ولا ينصح باستخدامها لحفظ بيانات أخرى مثل تلك التي يجب تخزينها في 


قواعد البيانات. في حالة الحاجة لحفظ بيانات يفضل استخدام onPause()‏ لكتابة كود الحفظ في قواعد البيانات 


يمكنك إختبار قدرة تطبيقك على حفظ حالة فعالية ما عن طريق تدوير جهاز العرض (المحمول أو الجهاز اللوحي): 
عنذما يتغير اتجاء العرض من راسي إلى أفقى والعكس» يقوم النظاء يتدمير الفعالية وانشائها مرة آخرى وو ذلك 
بتنفيذ الدالة ()/001(656103 ثم تنفيذ الدالة ()ع26ع0800 وذلك لتطبيق خصائص العرض الخاصة بالوضع الجديد 
للشاشة. في.هذه الحالة يجب أن تضمتن استعادة حالة الفعالية وكل البيائات الخاصة يها عند تغيير اتجاه الجهاز: 
وذلك حتى لا يلاحظ المستخدم أي فقد للبيانات أو تغيير في حالة الفعالية. 


أسئلة على الوحدة الأولى 
1. ما المقصود بالفعالية )Activity(؟‏ ولماذا يعتبر من الضرورة إدارة وفهم دورة حياة الفعالية (Activity‏ 


Life Cycle) 


3 ق قعل الین الذي تم انشا فی ارين 1-1 کر ق بکریر الجھاں لتغيين اتج العرض من آفقی إللى 
رأسي والعكس. ماذا تستنتج من تسلسل الرسائل التي يتم طباعتها؟ 


3 ما المقصود بالحافظة الخلفية 5]0[6 821 في نظام أندرويد؟ وما وضع العمل للفعاليات المحفوظه بها؟. 


4. لماذا يفضل استخدام الدالة onPause()‏ لحفظ حالة الفعالية (Activity)‏ على استخدام الدالة 
() 526125632665121 ؟. قم بالتحقق من الفرق بين الدالتين عمليا. 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 
الوحدة الثانية: 
بنية التطبيق (Application Structure)‏ 
يتعلم الطالب في هذه الوحدة: 


> . المكونات الأساسية لتطبيق أندرويد والفرق بينها. 
”ا . ملف الوثيقة (17116 اوهfزمة1)‏ ومكوناته وتعديله لتهيئة التطبيق للعمل بشكل صحيح. 
> . أنواع المصادر (5و19650106) الموجودة ضمن تطبيق أندرويد والوصول إليها. 


”7 .التعامل بشكل صحيح مع تغير الإعدادات مثل تغير جهة العرض (رأسي - أفقي) وشاشة العرض. 


لدراسة هذه الوحدة لابد من الإلمام بمفهوم الفعالية (Activity)‏ ودورة حياتها (إرجع إلى الوحدة الأولى)» كذلك 
لابد من الإلمام بتصميم واجهات التطبيق (1.,23:01165) باستخدام []210. 


مكونات تطبيق أندرويد 
يتكون تطبيق أندرويد من عدة مكونات تشمل بعض أو كل ما يلي: 


الفعاليات (و11116)دض): تستخدم الفعاليات تعمل الواجهاث التداعلية ثم شرج الفعالية (وا اه في الوحدة 
السابقة» وسيتم استخدامها بكثرة في التطبيقات الموجودة في هذا الكتاب. 


الخدمات (وعع56171): الخدمة هي مكون يعمل في الخلفية لتنفيذ عمليات يحتاج تشغيلها لفترة طويلة. الخدمة 
(عع561971) لاتوفر واجهة للمستخدم حيث تعمل في الخلفية بدون تدخل من المستخدم. على سبيل المثال» يمكن 
تفعيل خدمة تشغيل الملفات الصوتية في الخلفية بينما يقوم المستخدم بالتفاعل مع تطبيق مختلف» أوخدمة تزيل 
بيانات عبرالشبكة دون عرقلة تفاعل المستخدم مع التطبيقات الأخرى. لن يتم التطرق لبرمجة الخدمات في هذا 
الكتاب. 


مزودات المحتوى (2109710615 002]626): مزودالمحتوى يتحكم في مشاركة قواعد بيانات أو الملفات. 
يمكنك تخزين البيانات في نظام الملفات أو في قاعدة بيانات ع501.16»: والوصول إليها من خلال مزود 
المحتوى (270171061 ٤«عاره)).‏ يمكن أيضاً لتطبيقات أخرى الاستعلام أوحتى تعديل البيانات (إذا كان مزود 
المحتوى يسمح بذلك ). على سبيل المثال» يوفر نظام أندرويد مزود المحتوى الذي يدير معلومات الاتصال 
الخاصة بالمستخدم (28011061 Content‏ 00243015). على هذا النحوءأي التطبيق مع الأذونات المناسبة 
يمكنه الاستعلام عن جزء من المعلومات الخاصة بشخص معين. سيتم التطرق لمزودات المحتوى 01606 0©) 
(20110615 في الوحدة السابعة من هذا الكتاب. 


مستقبلات النشر (17615عع16 8103200256): مستقبل النشر هو المكون الذي يستجيب للرسائل المرسلة من 
النظام أو التطبيقات الأخرى. على سبيل المثال» عند إنخفاض مستوى شحن البطارية أو إعادة تشغيل الجهاز» 
يقوم النظام ببث رسائل للإبلاغ عن هذا الحدث. يمكن لمستقبل النشر (171عع106 870300356) الاستجابة 
لهذه الرسائل وتنفيذ إجراءات ما. مستقبل النشر (1ء17عع16 81030256) لا يشتمل على واجهة مستخدم» 
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صفحة . 12 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


ولكنه قد يرسل تنبيها لمستخدم (71011440301052) عند حدوث حدث ما. سيتم التطرق لمستقبلات النشر 


Receiver)‏ ]81020025) في الوحدة الثامنة من هذا الكتاب. 
ملف الوثيقة (Manifest File)‏ 


كل تطبيق أندرويد يجب أن يحتوي على ملف الوثيقة باسم dManifest.xm]‏ 


ذ0ل في المجلد الأساسي 


للتطبيق. يحتوي ملف الوثيقة على معلومات أساسية عن التطبيق حتى يتمكن النظام من تشغيله بشكل صحيح. الكود 
بالأسفل يوضح مثال لملف وثيقة (81311650) لتطبيق ما. يحتاج المطور في كثير من الأحيان إلى إجراء تعديلات 


في هذا الملف ليعمل التطبيق بالشكل المناسب. 


د ا ع لت 64ت 0# 


ttp://schemas.android.com/apk/res/android™" 
edu.ucas.FirstAndroidApp" 

ORES Ge > 110 

i OnRNamez ll. O > 


droid.permission.WRITE_INTERNAL STORAGE" /> 


droid.permission.WRITE_EXTERNAL STORAGE" /> 


91211256101726 SO a 1] 11 
:targetSdkVersion="18" /> 


:allowBackup="true™" 


icon="@drawable/ic_ launcher" 
label="@string/app_name" 


:theme="@style/AppTheme" > 


d:name=" 
tAndroidApp.MainActivity" 
SEELRNE MER 265211 CAEL 
eR Ea EN COM> POE EEA E > 


name="android.intent.action.MAIN" /> 
d:name="android.intent.category. LAUNCHER" 


<?xml version="1 
<manifest 
xmIné :android=™h 
package="ps. 
android:vers 
android:vers 
> ! <--الصلاحيات-‎ 
> 115 © 5 ©م-‎ 25115516 
android:name="an 
<uses-permission 
android:name="an 
<uses-sdk 
android 
android 


<application 
android 
UNCLE CLO S 
UNCLE GLO S 
android 
>!-- الفعاليات‎ --< 
وه‎ 0121517 AM GEOR 
ps.edu.ucas.Firs 
android: label="@ 
:14ت 1ك 7و‎ SOE OCEMOE 
EEE SE 11153162 
©4516 601 AME SOR GO ¢ 
<category androi 
f3 
</intent-filter> 
CJACEITLEVZ 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


</application> 
</manifest> 


سنقوم فيما يلي بشرح أهم المعلومات التي يحويها هذا الملف: 


وصف لمكونات التطبيق المختلفة من فعاليات (Activities)‏ وخدمات (Services)‏ وغيرها: كما ذكرنا في 
الوحدة السابقة» عند إنشاء أي فعالية يجب الإعلان عنها في ملف الوثيقة. أنظر المثال أعلاه حيث أن ملف 
الوثيقة يشتمل على فعالية باسم .(MainActivity)‏ 


الأذونات (Permission)‏ والتي يحتاجها التطبيق من أجل الوصول إلى الأجزاء المحمية من النظام مثل 
الذاكرة الخارجية أو الاتصال بالانترنت. على سبيل المثال» هذه بعض الصلاحيات التي يتم إضافتها إلى ملف 
الوثيقة )وع7/211 باستخدام الخاصية :<>uses-permission>‏ 


© 1 5 212115 ©م- 5 © 115 > 


android:name="android.permission.WRITE_INTERNAL STORAGE" /> 


<uses-permission 


android:name="android.permission.WRITE_EXTERNAL STORAGE" /> 


<uses-permission 
android:name="android.permission. INTERNET" /> 


حيث تمنح هذه الأذونات التطبيق إمكانية الوصول للذاكرتين الداخلية والخارجية والإنترنت على التوالي. 


الحد الأدنى و الأعلى لمستوى الواجهة البرمجية (1,6761 ۸۴1) التي يتطلبها التطبيق للعمل بشكل صحيح. 
e1‏ ۸۶1 هو رقم يحدد إصدار الواجهة البرمجية التي توفرها منصة أندرويد (10م2124 (Android‏ 
ويتم تحديده في ملف الوثيقة (321231456) من خلال الخاصية <101565-501>. من الهام تحديد قيم هذه 
الخاصية لأنها تحدد أرقام الإصدارات المتوافقة مع التطبيق. هناك قيمتان ضمن الخاصية <11565-501> يجب 
تحديدهما وهما: android:minSdk Version‏ و Version‏ ndroid:targetSdkه.‏ القيمة الأولى تحدد أدنى 
واجهة برمجية يحتاجها التطبيق ليعمل بشكل صحيح. يقوم نظام أندرويد تلقائياً برفض تنصيب التطبيق إذا 
كانت الواجهة البرمجية المستخدمة من قبل النظام أقل من تلك المحددة في الخاصية 
10 1010:11250117. عند تحديد هذه الخاصية يجب مراعاة طبيعة الأجهزة المتوافقة مع التطبيق 
وانتشارها في السوق: فمثلاً تحديد قيمة عالية للواجهة البرمجية يعني أن التطبيق الخاص بك لن يعمل على كل 
الأجهزة التي تعمل بالواجهات الأقدم والتي قد يستخدمها عدد كبير من الأجهزة. في المقابل فإن استخدام قيمة 
متدنية جدا يحرمك من استخدام الخصائص البرمجية الحديثة المضافة للواجهات البرمجية الأحدث. 


قيمة جروزو1ء0010:1356501597ح تحدد الواجهة البرمجية التي يستهدفها التطبيق » وهي تعني أن التطبيق 
تم اختباره على الواجهة البرمجية المحددة وأنه ليس هناك حاجة لأن يقوم النظام بأي عملية مواءة للتطبيق إذا 
توافقت الواجهة البرمجية للنظام مع واجهة التطبيق. لا يزال التطبيق قابل للعمل على الأنظمة القديمة (حتى 
الرقم المحدد في 100و1ء301010:13150129) ولكن قد تقوم الانظمة القديمة بعمل مواءمة تلقائية للتطبيق 
مما قد يؤثر على بعض الإضافات الغيرمدعومة من قبل النظام. 
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صفحة . 14 


الكلية الجامعية للعلوم التطبيقية 


الجدول 2-1 يوضح اسم منصة أندرويد (عجدتته]ة 006©).» رقم الإصدار («0ذوإم۷) ورقم الواجهة البرمجية 


.(API Level) 
)»ء رقم الإصدار («0إوم۷) ورقم الواجهة البرمجية‎ ٤٥4ء‎ Na جدول 2-1: اسم منصة أندرويد (مر‎ 
(API Level)’ 
API Level Version Code Name 
AP! level 21 5.0 Lollipop 
API level 9 4.4 - 4.4.4 KitKat 
AP!I level 18 4.3.x Jelly Bean 
AP! level 17 4.2.x Jelly Bean 
AP! level 16 4.1.x Jelly Bean 
API level 15, NDK 8 4.0.3 - 4.0.4 Ice Cream Sandwich 
API level 14, NDK 7 4.0.1 - 4.0.2 Ice Cream Sandwich 
API level 13 3.2.x Honeycomb 
API level 12, NDK 6 ااك‎ Honeycomb 
AP!I level 11 3.0 Honeycomb 
AP!I level 10 2 Gingerbread 
AP!I level 9, NDK 5 2.3 - 2 Gingerbread 
AP!I level 8, NDK 4 20S Froyo 
API level 7, NDK 3 2.1 Êclair 
API level 6 2.0.1 Éclair 
API level 5 2.0 Eclair 
API level 4, NDK 2 1.6 Donut 
AP!I level 3, NDK 1 1.5 Cupcake 
AP!I level 2 1.1 (no code name) 
API level 1 1.0 (no code name) 


اتجاه الشاشة (م0ناهامعذإه «ععإءء) للفعالية والتي تكون في أحد وضعين: الوضع الرأسي (أ1ة١٣0۲م)‏ 
وضع العرض لفعالية ما (راز۷نا۸) بحيث لا تستجيب 
الفا “ذلك باستدداع الخاصية 


والوضع الأفقي (عم1920562). إذا أردت تثب 
إن كان رأسياً أو أفقياء 


لتغير وضع الجهاز 


2 e 3 


00 


عنوان الكتاب 


رقم المقرر 


:screenOrientation‏ من داخل الخاصية 200157167 كما هو موضح في المثال التالي: 


"غ02231م"->602 1231© 6©12021ع0»2 5 : 02010 طلة 


كما هو الحال في ملف ,3311 الخاص بالواجهات» يمكن من ملف الوثيقة الوصول للنصوص المعرفة في ملف 
1ص×.sعtrinء.‏ فمثلاً» في ملف الوثيقة (8121150) الموضح مسبقاً: الخاصية 13061 الموجودة ضمن العنصر 


Android Developers, http://developer.android.com/guide/topics/manifest/uses-sdk-element.html ' 


صفحة . 15 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


0 تستخدم قيمة المتغير ع«تهم_مم3 المعرف في ملف 011«.وع5030. بالمثل» الخاصية 13661 
الموجودة ضمن الخاصية 200591 تستخدم قيمة المتغير 20310_201197119_)1]16 المعرف أيضاً في ملف 
.strings.xml‏ 


(Creating Resources) إنشاء المصادر‎ 


عند بناء تطبيق أندرويدء يوصى دائماً بإبقاء المصادر التي يتعامل معها llتطبResources)Jı (Application‏ 
منفصلة عن الكود. من أنواع المصادر التي يتعامل معها التطبيق: العبارات النصية «strings‏ الصور «images‏ 
أنماط التصميم وع5]771: ملفات هيكلة الواجهات ]133:00 وغيرها. هيكلية تطبيق الأندرويد مشابهة لما هو موضح 
في شكل 2-1» حيث أن المجلد عرو مخصص لحفظ ملفات الجافاء بينما مجلد و يستخدم لحفظ الأنواع المختلفة 
من المصادرء حيث يخصص لكل نوع من المصادر مجلد خاص داخل المجلد وع5. فمثلاً الصور تحفظ في مجلد 
بينما تحفظ العبارات النصية وع5)32 داخل الملف 20[1<:.وع 53 داخل المجلد وعں[ج۷. 


MyProject/ 
src/ 
MyActivity. java 
res/ 
drawable/ 
icon. png 
layout/ 
main. xml 
info.xml 
values/ 
strings. xml 


شكل 2-1: هيكلية تطبيق أندرويد 
جدول 2-2 يوضح أهم مجلدات المصادر ونوعية البيانات التي تحفظ بها: 


جدول 2-2: مجلدات المصادر (5ع1+690111:2) ضمن تطبيق أندرويد 


EE TENET 
يحتوي على ملفات الصور‎ drawable/ 
1325:0116 يحتوي على ملفات ,53411 التي تحدد تصميم هيكلية الواجهات‎ layout/ 
التي تحدد تركيب القوائم المستخدمة اليم‎ XML يحتوي عل ملفات‎ menu/ 
التطيق‎ 
يحتوي على ملفات 11× تحدد قيم يتم استخدامها في التطبيق مثل‎ values/ 
الألوان والأرقاد والعارات النصية.‎ 
يحتوي على ملفات الصور‎ drawable/ 
1325:0116 يحتوي على ملفات ,53411 التي تحدد تصميم هيكلية الواجهات‎ layout/ 
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صفحة . 16 


الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


ملاحظة: المصادر التي يتم حفظها في المجلد وج هي المصادر الإفتراضية التي يتم استخدامها في التطبيق. أحياناً 
قد تحتاج إلى مصادر مختلفة لتتلائم من الأوضاع المختلفة لعمل التطبيق. على سبيل المثال» التطبيق قد يعمل على 
أجهزة مختلفة الحجمء وبناءً على ذلك فإن تصميم الواجهات وأنواع الصور المستخدمة قد يختلف من جهاز لآخر. 


لتصميم التطبيق بحيث يتلاءم مع ظروف العرض المختلفة» لا بد من حفظ مصادر بديلة بالإضافة إلى تلك 
الإفتراضية ليتم استخدامها عند الحاجة لذلك. عند تشغيل التطبيق» يقوم نظام أندرويد تلقائياً باختيار المصادر 
المناسبة بما يتناسب مع إعدادات الجهاز. 


لتحديد مصادر بديلة لإعدادات الجهاز المختلفة» يجب اضافة مجلد داخل المجلد وم بالصيغة التالية: 
<resources_name <- > config_qualifier >‏ 


حيث <221706_وع01110وع1> هو اسم مجلد المصدر مثل >qualifier> .drawable «values «layout‏ يمثل 


res/ 
drawable/ 
Ji COI o IAC) 
background.png 
drawable-hdpi / 
1 CO» AG 
background. png 
لاحظ أن المجلد 1م01353616-0 يحوي الصور التي يتم استخدامها للشاشات ذات الدقة العالية وهو ما يعنيه‎ 
المقطع 1م لط. عند تشغيل التطبيق» يقوم النظام تلقائياً باختيار مجلد الصور المناسب لإعدادات الجهاز: حيث يتم‎ 
استخدام الصور من المجلد 0313616-01 إذا كان الجهاز ذو شاشة عالية الدقة» بينما يتم استخدام الصور من‎ 
المجلد 01252616 لغير ذلك من الأجهزة.‎ 


مثال آخر على ذلك هو تحديد تصميم مختلف للواجهة إذا اختلف اتجاه الشاشة (0116248]100) أو لغة الجهاز. في 
هذه الحالة يتم إنشاء مجلد باسم 016م-133:010 يحوي تصميم الواجهات للوضع الرأسي (0011216) أو مجلد باسم 
139010-10 يحوي تصميم الواجهات للوضع الافقي أو 1ه-]133:010 ليحوي تصاميم واجهات متناسبة مع اللغة 
العربية. 


(Accessing Resources) الوصول للمصادر‎ 


بعد إنشاء المصادرء قد تحتاج للوصول إليها أثناء بناء التطبيق. هناك طريقتين للوصول للمصادر: الوصول من 
خلال الكود أو من خلال [/200. 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


كل المصادر التي يتم إنشاؤها يقوم النظام تلقائياً بإنشاء صيغ معرفة لها (17 وحفظها في ملف خاص اسمه ۸. 
الصيغ المعرفة تأخذ الشكل التالي: 
R.<resource_type>.<resource_name >‏ 


حيث <6م197_ع01010وع1> يمثل نوع المصدر مثل ع5]1512» ou‏ رھاء 01313616 وغیرہ بينما 
<165011106_113126> تعني اسم المصدر . فمثلاً» المعرف التالي: 10.5]1128.2011715'_)1]16 يستخدم للوصول 
للعبارة النصية عماع)ء التي تحمل اسم 20017167_)1]16. المعرف 1701120ع12.01135/3016.63612 يستخدم للوصول 
لملف الصورة الذي يحمل اسم 70110ع631 داخل المجلد 0135:3616. الأمثلة التالية توضح كيفية الوصول إلى 
المصادر برمجيا من خلال الكود: 


مثال 1:الوصول إلى ملف صورة باسم 1311286 لعرضها في عنصر واجهة من نوع 1570286171655 
imageView.setlImageResource (R.drawable.myimage) ;‏ 
مثال 2: تغيير عنوان الفعالية (/201510) باستخدام العبارة النصية 1]16) 
(getResources )( .getText (R.string.title));‏ 2111 »ع5 . () getWindow‏ 
مثال 3: تحديد ملف هيكلية الواجهة باسم ع171315_5©016 عند إنشاء الفعالية 
setContentView (R.layout.main screen);‏ 
ه الوصول من خلال XML‏ 


عند إنشاء ملفات ,753211 للواجهات وغيرهاء يمكن اعطاء قيم لعناصر ,5111 باستخدام قيم معرفة في ملفات 
أخرى. الصيغة العامة للوصول لأي مصدر من خلال ,53/11 تأخذ الشكل التالي: 


@ <resource_type>/<resource_name > 


حيث <هم(165011106_]8> يمثل نوع المصدر مثل وہ ناء 06ا0/ق13»ء 01353016 وغيرهء بينما 
<165011106_123116> تعني اسم المصدر. 


المثال التالي يوضح كيف يتم إعطاء قيمة للنص المعروض على الزر Button‏ باستخدام عبارة نصية string‏ 
معرفة باسم زص ناه (أنظر الخاصية غ0201010:]6): 


SBUEE OR 
تلك لت‎ 5141 A YOU A GE MSE N Ba EEN E 
AME EOE ال‎ 35761315 MOO MES ES COME CME 
ARSE OLE Ee XEL CSE FIRO / ات‎ 51252 > 
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صفحة . 18 


الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


:(android:text مو‎ 20101 


GIREN EULESS 
xmlns:android="http://schemas.android.com/apk/res/android" 
ممه‎ 161 Le OUE_ WAGE VELL ECO CE 
AME EOE E LE OE eG MES E O Bae E 
aNdrOId:LeEXECOl Or  CCOlOr/OopPadque _FedL 
51262116: EEX مك عر 4 1 ع‎ ELELEY 7> 


(Assets Folder) مجلد الممتلكات‎ 


يوفر نظام أندرويد مجلد آخر ضمن مجلدات التطبيق حيث يمكن حفظ الملفات المختلفة. يسمى هذا المجلد وأعووه. 
الفرق بين مجلد 2556]5 والمجلد ومع أن النظام لا يقوم بإنشاء أرقام معرفة 17 للملف الموجودة في المجلد 
5. يستخدم مجلد وعووج لحفظ الملفات التي لايمكن حفظها في ملف وع مثل ملفات بالامتداد )×)» ملفات 
الصوت (5010. ,3م52. ,17307.) وغيرها. يتم الوصول إلى الملفات في مجلد 565و عن طريق الكائن 
1 والذي يمكن الوصول إليه بتطبيق الدالة ()5]ءو5مغعع داخل الفعالية (راز۷ذا۸). يوفر 
عدة دوال للتعامل مع الملفات مثل ()1156 لاستعراض الملفات و ()0062 لفتح ملف ما. الكود 
التالي يوضح كيفية قراءة محتوى ملف )]2.])ع] موجود في مجلد 255615 وطباعته كرسالة. 


5119112 CLASS AS SEES CEME 6ك ميقعت‎ 6172857 1 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
كدعا‎ 
InputStream is = 
SEENS SEE S (EOE ) EEE ع‎ 
int size = is.available(); 
veel ll CU fe Mew VEEN SC 
15 . 20ع2‎ (buffer); 
5ه‎ 5 07 
SE IMO 6061262 > يرت‎ SENOS (DUE EOE) 
1179-9-5 5 ٠ ma Kelex E (GE EAD لل‎ 1-62 E 1 OREOR 6 عاكدت‎ )( | 
content, Toast. LENGTH _ LONG) .show )( م‎ 
[ CAECM )1 28526 EL OM كت‎ ! 
CBE 65 6 ACRE ACE (E 


} 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


التعامل مع تغيير الإعدادات (Handling Configuration Changes)‏ 


إعدادات الجهاز قد تتغير في أي وقت مثل تغير اتجاه العرض (أفقي - رأسي) أو تغير اللغة. عندما تحصل مثل هذه 
التغييرات» يقوم نظام أندرويد بإلغاء الفعالية الحالية (4115169) وإنشاء واحدة جديدة عن طريق تنفيذ الدالة 
(02106510/0 ومن ثم ()ع0200636. إعادة تشغيل الفعالية يهدف إلى جعل التطبيق يتكيف مع التغيير الجديد 
باستخدام المصادر والواجهات التي تثلاءم مع الإعدادات الجديدة. عند إعادة تشغيل الفعالية يمكن استرجاع حالتها 
وبياناتها عن طريق تطبيق الدالة ()0253561256]82651246 أو ()0521156 لحفظ حالة الفعالية قبل إيقافها» ومن 
ثم تطبيق الدالة ()ع]021965]0161256806518 أو onStart0‏ لاسترجاع البيانات. 


إضافة الخاصية 201010:50166200116212602 ضمن خصائص الفعالية (4097167) في ملف الوثيقة 
nif‏ وذلك لتثبيت طريقة عرض التطبيق في وضع رأسي (أو أفقي) مهما تغير وضع الجهاز. كذلك من 
الممكن إيقاف إعادة تشغيل الفعالية عند حصول تغيير بالإعدادات بحيث يتم التعامل مع هذا التغيير برمجياً. يتم ذلك 
بإضافة الخاصية 22011010:000400223265ح ضمن خصائص الفعالية ((8ق]420503/) في ملف 
الوثيقة (71211151) كما هو موضح: 


>25 6 6 11 22104 617 أت لات تت‎ mame > MYATT ع‎ VL 
android:configChanges="orientation | keyboardHidden" 
android: label="@string/app_name"> 
في هذه المثال يتم التصريح بأن الفعالية ستتولى التعامل برمجياً مع تغيير اتجاه العرض 01165124105 أو في حالة‎ 
إخفاء لوحة المفاتيح» وذلك دون الحاجة لإعادة تشغيل الفعالية. في هذه الحالة يجب تطبيق الدالة‎ 
داخل الفعالية والتي يتم تنفيذها تلقائياً عند حصول أي تغيير في الإعدادات.‎ هn‎ Configuration Changes) 
يمكن كتابة كود في هذه الدالة لتنفيذ الإجراء المطلوب كما بالمثال التالي:‎ 


0 ع0 221ع0177‎ 
BUCS WORE OMEOM E HOU 21 6 HOME MAREE CSR E 16 مدن‎ 2 16 A جرت‎ 
newConfig) { 

super.onConfigurationChanged (newConfig); 


CMEC KES Ee SENEMA OM OE EME شك شع‎ 
11 (newConfig.orientation 
==Configuration. ORIENTATION LANDSCAPE) { 


Moa Ss E makeme xe ) ERIS, lam 15 "متك‎ ROSS E LENGER SHORE) SRO O 
}Jelseilf (newConfig.orientation 
==Configuration. ORIENTATION PORTRAIT) { 


10638 5 EMS CRESS E EES BOE EA E 7 5548186 EEE SHOE DESO 1 8 
} 
} 
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في هذا المثال أعلاه يتم عرض رسالة تبين اتجاه عرض التطبيق وذلك عند حصول أي تغيير في الإعدادات. لاحظ 
أنه يتم تمرير الإعدادات التي تغيرت إلى الدالة. 


في الغالب لن تحتاج لتطبيق هذه الدالة حيث يفضل إعادة تشغيل الفعالية (رازتامA)‏ عن تغير الإعدادات وذلك 
حتى يتم استخدام المصادر المناسبة للاعدادات الجديدة تلقائيا. على سبيل المثال» عن وجود تصميم واجهات خاص 
في وضع العرض الرأسي 0116م في مجلد 16وم-]133/00» يقوم النظام تلقائياً باستخدام هذه الواجهات إذا تم 
تغيير اتجاه العرض للوضع الرأسي. 


كذلك يمكن فحص إعدادات الجهاز برمجياً من داخل الفعالية (69ز0زاء.4) باستخدام الدالة 
)t{Resources).getConfigurationمع.‏ المثال التالي يوضح كيفية معرفة اتجاه العرض برمجيا عند بدء 
تشغيل الفعالية (/15103اءه): 


protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
1 2 (ERIS. 05 ERESOUE CES )( GCE 526621 2 1 طناك‎ 2 EN OM )( : عت‎ 1 2216261-11 >> 
COM امم 6 لم ينا روك‎ OE TENT AEN ON 22ل 189ل كسا‎ 
Toast.makeText (this, "landscape", 
LOaAS E. LENGE SEORT) SRO O 
else 
لك‎ (ERIS. Ge 6225561155255 )( : 0 9 66610 2110116 كت‎ ETON )( - 1ت 1 عدت‎ 63 ELON >> 
COM E 16 112 2 ETON + ORIEN ATION 12 1 لق‎ 
TOA SE CMa Re REE KERNS, عم"‎ 21 
Toast. LENGTH SHORT) .show(); 


} 


تمرين عملي (2-1) 


يهدف هذا التطبيق البسيط إلى التمرن على بعض المفاهيم الواردة في هذا الفصل مثل تغيير إعدادات التطبيق من 
خلال ملف الوثيقة (721231150): الوصول للمصادر وتحديد مصادر بديلة لتلائم الإعدادات المختلفة للتطبيق. 


التطبيق له واجهتين كما هو موشح بشكل 2-2 : الواجهة الأفقى تعمل في وضع العرض الأفقي حيت تتكون من 
مجموعة من الأزرار المعروضة أفقياً وأسفلها صورة لمبنى الكلية الجامعية. الواجهة الثانية تعمل في وضع العرض 
الرأسي وفيها يتم عرض الأزرار رأسياء ويتم عرض صورة لشعار الكلية الجامعية. يتم اختيار الواجهة وتغيير 
الصورة تلقائيا بناء على وضع العرض. 
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۶ One 
ApplicationStructure Two 


One Two Three Four Five 
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Lasser of Mrov ston + 


شكل 2-2: واجهتا التطبيق في الوضعين الرأسي (٤ذه٣٤إه۴)‏ والأفقي (عم1,220527) 
الخطوات التالية توضح مراحل بناء التطبيق: 


أولاً: إنشاء الواجهات: بناء على أن التطبيق له واجهتين مختلفيتين» نقوم بإنشاء ملفي 1× لتصميم الواجهة: أحد 
الملفين مخصص للواجهة بالوضع الرأسي ونضعه في المجلد layout‏ والملف الآخر يحمل نفس الاسم ولكن في 
مجلد آخر بالاسم 123:0116-1320. لاحظ أن اسم المجلد يحدد الإعدادات التي يستخدم عندها ملف الواجهة» فالمجلد 
الذي ينتهي اسمهه ب 1200 يستخدم في وضع العرض الأفقي (6م1,32005023) بينما يستخدم المجلد الآخر في غير 
ذلك. ملفات التصميم موضحة بالأسفل: 


أولاً: تصميم الواجهة الخاصة بالوضع الرأسي 


/ / layout/activity_main. xml 

<RelativeLayout 

MIMS : 22 سك‎ 6 EAE 68 2/1 SCMeEMaAS ARSEN COM لت‎ AEE S7 AN EOEO AL 
SmI RMSE EOSLS- 66 5 : / / SEMeMaA 5 7 ARO SLC COM EOL SL 
AMEE OG E EOE GSE D> Ema Ee MOA Ee ME 
311 1ك‎ 0114: la yOUE Men GES IMAC ale Ell 
android:paddingBottom="@dimen/activity_vertical_ margin" 
android:paddingLeft="@dimen/activity_ horizontal margin" 


android:paddingRight="@dimen/activity_horizontal margin" 
android:paddingTop="@dimen/activity_ vertical margin" 
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12 © OLS كدت 6 مت‎ 6 1 COM دك‎ 210 LE APE UTES EN OMS IEE UGE RE MAM عات ا‎ E 


E 
CEU 
android:id="@+id/buttonOne" 
:تدك تنك لت‎ EA VO E EGE MS A COM EEN E 
AEE 2A OME e O IES ESS COM ECEME 
RE EOE E E OE CEME 12ت 12 3ك الات‎ aA LS E E 
ARA E كي :01 1ت‎ EL CSE INO BU EEOROnREL V> 
> 2 11 
android:id="@+id/buttonTwo" 
18ت 2ك :16ت 1ك لت‎ EGE MS AS COM EEN E 
متك لت‎ 2 EG E EA OIE J E ES IES ESS COM ECEME 
AEE EEG EES OU E COME CE ع 2 لل تع ل 12 مات‎ 
android: layout_below="@+id/buttonOne" 
ARIFO EEE CSE IRO LED EE ORO > 
CEDEL 
android:id="@+id/buttonThree" 
11ت عذك ارالك‎ 2 LE VMOUE WIC EAS COMES 
AMEE RG Sa OWE Me O MES ESS COM ECEME 
MEE OG E E OE CEME CE 12ت 12 شرك‎ A SE EE 
android: layout_below="@+id/buttonTwo" 
517401 610: 1ح تع‎ CSE ROADIE EORTC م‎ 
2101 
android:id="@+id/buttonEFour™" 
2ت متك الث‎ 11: A OU E IEE MS كرد عن‎ COM EE E 
AMOEOLES LAVOE MELO IEEAS CORECOR E 
AME EOE E امه 1 5312151516 1ق م _ 25761315 ال‎ aA LSE EE 
android:layoult_ below="€¥+id/buttonThree" 
AMA ROG د‎ EESGE > CSE RO BU EE OREOR حر‎ 
<EUELOD 
android:id="@+id/buttonFive" 
AME EOE E E OE GE MS 7572235 COME EM E 
MAES 601: EOE ME MO MES ES COR EEE 
:11ت 1ك لت‎ a VOU E لدت 6 11 تت‎ OM ZORE aA lS 1س ع‎ 
android:layout_ below="@+tid/buttonFour" 
5120115 كن لت‎ SEE XE OSE ERO /BU EE OR EEL > 
<ImageView 
android:id="@+id/imageView" 
نمال 16د شامسة‎ SE RS ES COREE E 
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eG E 112172 ME EG ES IES COM ECEME‏ تنك لت 
android: layout_below="@G+id/buttonFive"‏ 
AOE aA LSE EE‏ شاك E EE OE COME CE‏ 1ك 6116 10ت 
android: layout_marginTop="24dp"/>‏ 
</RelativeLayout>‏ 


ثانياً: تصميم الواجهة الخاصة بالوضع الأفقي 


/4 Lavo = LAC ECELA L_I o SL 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 

Sm MS EOC LS 6665 : / / 5 كت‎ 2102-57 7 ARO ORA COM E OOS 


FA VOI _ امنا‎ E DSma EER E2 EE E 
AOE ME O DIE > Ema 2 م 10م‎ 
android:paddingBottom="@Gdimen/activity_vertical 


AMEE © 11 4 5 
511131 12 © 261 3 J 


make im 

android:paddingLeft="@Gdimen/activity_ horizontal margin" 
android:paddingRight="@dimen/activity_horizontal_ margin" 
android:paddingTop="@dimen/activity_ vertical margin" 


EOS COR الاكق مدق ع‎ COM exam LE ADE TEA 5 21 OMS EE USE 125 Ma 11 E 


لت 0ك اه ع 60112 اك 1 1E WEF‏ 

ع قزمت 21527723 _ SMO‏ 

CORES E‏ م عدن لع MOLE‏ نه 1د 
layoul _ 1261:6120" 4+1 0/2 111-02776"'‏ 


EEX E CSE FINO BU E EOROnRE lL ١ 


E> CO AES ABE ESR EWS 
drold: 
510+ 
2510+ 
2317 


SMO TE ERSNI EAD COME CN E 
MS MOE Me MS ES NIVEA عت‎ 2 CT E 
layout_alignBottom="@+id/buttonOne" 
1ل‎ 2576105 EO He iE 5015>77 7161/5115 EEE 


LCS ENING LOUIE E ONO E‏ كع ؟ 


id="@+id/buttonThree" 

SMO GE ERS EAD COM IE CN E 

MA MOE Me ES ES EAS E SECT E 
layout_alignBottom="@+id/buttonOne" 
1ل‎ 2176105 CEME E EOE MAO E a LS E E 


EEE LL 56 EOLA EEO e EL 
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droid: 
droid; 
2510: 
02520: 


612 © CÎ 


droid 


droid 


droid: 
droid: 
2510: 
Jrold: 
217 


droid 


Vî > 


SEM 5 لك‎ 


EON‏ 2 810ل 


لك 2 كلك 


SEIU EE O 
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android:id="@+id/buttonFour™ 

AMEE E ال‎ 25761315 EGE MS ES COME CM E 

AME EO EG ال‎ 2576135 MOOS MES ESS COME CE 

LS EEE ll‏ تع سات 12 مراك E a VOU E COMI EC EE‏ 11ت ملك لت 
android:layout_alignBottom="@+id/buttonOne"‏ 
android:layout_toRightOf="@+id/buttonThree"‏ 
م لمع DUE‏ 126 ع GS EEE >C SE‏ 601 512012 


221 در‎ 
android:id="@+id/buttonFive" 
17ت‎ 01 02114: la yOu E Wid RSI WES OOM EOE 
AEE ORG SEA VMOU E NEO ES ESO CON EEN E 
android:layout_alignBottom="@+id/buttonOne" 
android: layout_toRightOf="@+id/buttonFour™ 
AMOEOL GA : 6 عدت‎ 6 >C SEID SI ABU E E OR Ee ll > 
<ImageView 
android:id="@+id/imageView" 
1ك لت‎ 014: la vVOUE WI SERS IWEAE COMEEM E 
AREA EOE ال‎ 257106 _ 1861© ES ES CON EEN E 
android: layout_below="@G+id/buttonTwo" 
AM ذلك‎ 5 MG 1121315 CEME HON ASME LS E EEE 
android:layout_marginTop="24dp"/> 
</RelativeLayout> 


ثانياً: إنشاء الفعالية (رزناA):‏ الكود بالأسفل يوضح الفعالية (رز۷ن)114ه1) المستخدمة في التطبيق: 


LEON EY‏ 5 لكت عدت TN EY‏ ع ك شاض ل 15 2-5-5 لنت كك تل واس 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
SUPE. ORCEEE Ee (SEE IM SIE ARE S Ea Eê) j 
SE EC SMIEE N E Ve (RST 217 لات‎ 2 aC E Ey Ma AM) 
ImageView image = (ImageView) 
this.findViewById(R.id.imageView) م‎ 
if (ERIS Ge ERE 56115925 )( Ge ECON 1 طلا كن‎ 2 621 512 ) ( SENEM ع‎ 2 6 1 OM 
5> COME 16 تل‎ 2 TON ORT ENTAR TION فضا ال ص‎ CAEE) 
mage 7 Sel MII EORE SOMES ) 7 سنك‎ awa Be Meas BU LATE) 
el 53 MEKEM 5 SCE ERESOUECES )( OE ECORE OME AEN OR OE 
OK EM EAE OM => CC OME OU A EO OE TEN TAT TON EORERAT E) 
image.setlImageResource (R.drawable.ucas_ logo); 


O OO ذت ال‎ OE O OS 


} 


650 O ê U RS كا‎ @ 0 dû0 50 00 00 00 0 0 0 
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لاحظ أنه في الدالة ()066ع000 (عند بداية تشغيل الفعالية) يتم إنشاء الواجهة عن طريق الدالة 
1671610 والتي يمرر لها المعرف الخاص بملف الواجهة وهو R.layout.activity_main‏ (أنظر 
سطر رقم 6). لاحظ أيضاً أن هذا المعرف يمكن استخدامه للوصول لكلا ملفي الواجهة. يقوم النظام تلقائياً باختيار 
الملف المناسب بناءً على وضع العرض: فإذا كان وضع العرض أفقياً (©م1,2300503]) يتم استخدام ملف الواجهة 
ctivity_main.>n1ه‏ الموجود في المجلد 1298:0106-130» بينما إذا كان وضع العرض رأسياً (2011810) يتم 
استخدام ملف الواجهة [2017197_17211.11 الموجود في المجلد 125'0116. 


بعد ذلك يتم فحص وضع العرض برمجياً عن طر يق الدالة getResources().getConfiguration()‏ وبناءً 
عليه يتم تغيير الصورة (أنظر الكود من سطر 9 إلى 15). لاحظ أيضا أن الوصول للصورة تم من خلال 
allعرف:>R.drawable.<image_name.‏ 


أسئلة على الوحدة الثانية 
1. ما الفرق بين الفعالية (4119167) والخدمة (عع96101)؟ وفيم تستخدم كل منهما؟ 
2. ما الفرق بين استخدام المجلد و4556 والمجلد وع لحفظ المصادر؟ 
3. قم بإنشاء تطبيق أندرويد لعرض نص محدد باللغة العربية أو الإنجليزية في عنصر من نوع wع۷¡i†×٥]"‏ 
وذلك بناءً على اللغة المحددة في إعدادات الجهاز. فمثلاً» عند تشغيل التطبيق يتم عرض جملة " عط" 
niversity College of Applied Sciences‏ 0" إذا كانت اللغة المحددة في إعدادات الهاتف هي 


الإنجليزية. وعند تغيير اللغة إلى العربية من إعدادات الجهازء يتم عرض الجملة "الكلية الجامعية للعلوم 


تلميح: استخدم مجلدين واحد باسم مع-721065 والآخر باسم :ه-و72106 وذلك لتحديد نص إنجليزي وآخر 
عربي في ملف 5115.111 الموجود في كلا المجلدين. 


فان على الق الا ف :2 و ذلك ار خم [لخط لتس السدور كن فقا :عله ر كه ا 
جهاز ذو شاشة كبيرة. 
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الوحدة الثالثة: 
التعامل مع عناصر الواجهة برمجياً 
(Interacting with UI Components Programmatically)‏ 
يتعلم الطالب في هذه الوحدة: 
”7 معالجة أحداث التفاعل مع واجهة المستخدم. 


”7 الوصول لعناصر واجهة المستخدم برمجياً والتعامل مع أنواع عناصر الواجهة المختلفة. 
”ا التعامل مع قائمة العرض (ListView)‏ وتعبئتها باستخدام أنواع المحولات المختلفة (Adapter)‏ 


لدراسة هذه الوحدة لابد من الإلمام بمفهوم الفعالية (Activity)‏ ودورة حياتها (إرجع إن الوحدة الأولى)» التعامل 
مع المصادر (إرجع إلى الوحدة الثانية)» كذلك لابد من الإلمام بعناصر الواجهة الأساسية وكذلك تصميم واجهات 
التطبيق (1,259:0015) باستخدام .XML‏ 


درست في مساق سابق إنشاء عناصر الواجهة المختلفة مثل ٠5/16آ)2:ع'1» Button ١10161)‏ وغيرها من 
العناصر. كذلك تعلمت طرق الهيكلة المختلفة 1,3300165 لتنظيم عرض عناصر الواجهة (لمراجعة هذه المفاهيم 
يمكن الرجوع إلى الفصل الثالث في المرجع رقم 1 أو الفصل الثالث في المرجع رقم 7). سنتعلم الآن طريقة 
الوصول لعناصر الواجهة برمجياً والتفاعل مع الأحداث 5]م207 71]. كذلك سنتطرق للتعامل مع بعض عناصر 
الواجعة شائعة الإستخدام مثل القائمة (38938]) وطريقة عرض البيانات: المختلفة بها باستخدام المخولات 
.Adapters‏ 


معالجة أحداث الوجهة برمجياً (Handling UI Events)‏ 


يقصد بأحداث واجهة المستخدم 11:60]5 01 هي الأحداث الناتجة عن تفاعل المستخدم مع مكونات الواجهة مثل نقر 
الأزرار أو لمس الشاشة. 


للتعامل مع أي حدث يحصل على أي عنصر في الواجهة يجب أولا الوصول لهذا العنصر من داخل الفعالية» وذلك 
يتم باستخدام الدالة ()15077169783/11 والتي يمرر لها الرقم المعرف للعنصر (له صيغة: 
e<‏ ement_namاR..>e.‏ لكل عنصر في الواجهة رقم خاص يختلف عن أي معرف للعناصر الأخرى. يتم 
إنشاء هذا المعرف تلقائياً بعد إدارج العنصر في ملف التصميم 0].2001اه135:0. تقوم دالة find ViewBy1Id)‏ 
بإرجاع مؤشر لكائن من نوع 771677 وهو نوع فئة الأب (6م97 61701355م51) لكل عناصر الواجهة. نقوم بعمل 
ناوه للعنصر المرجع وذلك لتحويله للنوع المطلوب. فمثلاً» للوصول للزر 511021 يمكن استخدام الأمر 
لل من دلكل الفعالية (7 امه بعد الحصول على مؤش للكائن. الخاض بالزر» يكن التعاملمعه باستهداء 
الدوال المختلفة التي توفرها الفئة 01255 811]]01. 


EEE OM 56 كع 06 2 < تع‎ ERI GS 7 سيت تناع‎ TE KERE TEE BE EE OME 
E EO. SE ERE E ) 6 11112 Ree 
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بعد الوصول لعناصر الواجهة برمجياًء يمكن التقاط الحدث (تفاعل المستخدم مع العنصر) أول وقوعه عن طريق 
تسجيل ما يسمى بالمستمع (61م1.15]6]) والذي يعلمك تلقائياً بحصول حدث ما بتنفيذ دالة راجعة ع1ع21162© 
.method‏ الفئة cView‏ والتي تتفرع منها كل فئات عناصر واجهة المستخدم» تحتوي على مجموعة من الواجهات 
البرمجية (ععه؟إعام1) .كل واجهة برمجية (ع10]6720) تحتوي على دوال مجردة والتي يمكن تطبيقها حسب 
الحاجة للاستماع للأحداث المختلفة. 


الواجهة البرمجية (Interface)‏ تحتوي فقط على دوال مجردة دون أي تطبيق» وعلى المستخدم تطبيق هذه الدوال 
بكتابة الكود المناسب. للتفاعل مع حدث معين على عنصر واجهة» يجب تسجيل واجهة مستمع جديدة لدى عنصر 
الواجهة وتطبيق الدوال الموجودة به لتنفيذ الإجراء المطلوب. فمثلاء للاستجابة لحدث على زر معين 810600» 
يجب على تسجيل واجهة مستخدم من نوع 1عمء]15آ1ع77169/.020011 لدی الکائن ]281 (عن طريق تنفيذ 
الدالة () Listener‏ t0nC1ickهء‏ ضمن الفئة ١م‏ 8» ومن ثم كتابة الكود الخاص بالدالة المجردة 0>اء6020011 
لتحديد الإجراء المطلوب تنفيذه عند الحدث). عند النقر على الزر يقول النظام تلقائياً بتنفيذ الدالة ()11012 00 لينفذ 
الإجراء المطلوب. 


button.setOnClickListener ) 
new Button.OnClickListener () { 
BUD LE VONO OME LE Te 0 
1 2601017 EO Be Per SLEMeS WHEN BOUEEON 1S لت‎ 


} 


تمرين عملي (3-1) 


لتوضيح كيفية التعامل مع الأحداث بمثال عملي» سنقوم بعرض الخطوات الكاملة لتطبيق بسيط واجهته موضحة 
بالشكل. تتكون الواجهة من زر مكتوب عليه M٥”‏ ووع517“ وعنصر عرض من نوع /16]5/1617. الحدث الذي 
نود تنفيذه هو تغيير محتوى النص المعروض في 16177161 عند النقر على الرز 26551/16. 


الكلية الجامعية للعلوم التطبيقية 


MyFirstApp 


Status 


Press Me 
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عنوان الكتاب 


رقم المقرر 


ملف هيكلية الواجهة لهذا المثال موضح بالأسفل» حيث أنه يحدد خصائص العنصر 28110 والمعرف بالإسم 


.myText View والعنصر 161771607" والمعرف بالاسم‎ »myButton 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android"™ 
android:id="@+id/myLayout" 


US E DS E N BA EEN E‏ نت 5 تا 
AVS REGS ES HEMN Pee EL >‏ 


2J‏ 161 هت 12 10ت 


ا 5 © 11 © كا أك اكرات 


SEU EE O 


ARMA FOG : 1 01-7 CT 1A /MYEUIE E O 

AMEE EG E A OU E IGE MS EA) COM EEN E 

AM EEO RG A OME Me OIE LESS COM ECEME 

AME EOE E HE OE CEME CE O AOI ASE EE 

E lAVOUE CEM EEE Me EGA LS EEN‏ 1ن تلك للك 
android: text="@string/mybutton_ string" />‏ 


<TextView 


android:id="@+id/myTextView" 

E Le OU _ WIC EAMES COMES‏ 1ك ملك لت 
AMEE E A MOE MOOS DIES HES COME CME‏ 
android:layout_above="@+id/myButton"‏ 

LS EEE ll‏ تع ات 12 مدان E la VOU E COME CEH‏ 14ت 1ك 11ت 
ARE EOE SAMO IE Ma FONE E OM 2E‏ 
android: text="@string/mytextview_string™‏ 
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عنوان الكتاب 


رقم المقرر 


textAppearance="?android:attr/textAppearanceLarge"‏ : 02010 نه 
3 
</RelativeLayout>‏ 


بعد تصميم الواجهة» يجب التعديل على كود الفعالية (/41171) وذلك لتسجيل مستمع للحدث (1عمع]15.]) ليقوم 
بتنفيذ الإجراء المطلوب عن النقر على الرز. كود الفعالية المعدل موضح بالأسفل: 


E‏ 2 لكت 2ت MENACE N EY‏ 2-5-5 لنت كلتل وناك 
@GOverride‏ 
protected void onCreate (Bundle savedInstanceState) {‏ 
SUPE. ORCEEEa Ee (Save IR SIE 296 SIE a Eê) j‏ 
E Ve (RE Tayo aC EREY Ma iM)‏ لت 6 6117 6 ا SE‏ 
} 
@GOverride‏ 
PEO LECCE CS UO OMSESEE )( !‏ 
SUPER ORSIE AE EOE‏ 
EMA VALE WE VMLO (REO MEE EO‏ ست 1 BIE EO OUEEON (BUME‏ 
button.setOnClickListener )‏ 
new Button.OnClickListener () {‏ 
BUCO IE VONO ORCL E e 0 ١‏ 
TextView myTextView = (TextView)‏ 
E A MST EE VI G(R ETE MYLES EVA OW)‏ 
myTextView.setText ("Button clicked");‏ 
/ 


ا ذا كن حن يرث IAS‏ 6 ©) د 


oo oo oo oo‏ اوه ا وه هه هه هه © لم WNN‏ صلم I O U‏ 00 فا هك دم 


ال ا ا ل ل ا ل 0 


لاحظ أن الكود المسؤول عن التعامل مع الحدث تمت كتابته في الدالة (02518110 ( أنظر سطر رقم 9). تم اختيار 
الدالة ()005621 لأنه عند تنفيذها يكون قد اكتمل إنشاء عناصر الواجهة ومن ثم أصبح في الإمكان الوصول 
للعناصر الموجودة بها عن طريق الدالة (171677.037/16/833/100( أنظر سطر رقم 15). إنشاء واجهة المستخدم 
يتم في الدالة ()ع]جع2')ررمء وتصبح الفعالية (41197107) مرئية عند تنفيذ الدالة ٠,5٤۲۲0‏ (راجع دورة حياة 
الفعالية وتسلسل تنفيذ دوالة الاتصال الراجع ع03116301). يمكن كتابة الكود أيضاً في الدالة ()08068]6 ولكن بعد 
تنفيذ الدالة ():2145/1655ع560026 والمسؤولة عن إنشاء الواجهة. 


بعد الوصول إلى الكائن 20371811660 باستخدام الدالة ()4201716583/101» نضيف المستمع (1.1566261) للكائن 
5800 بتنفيذ الدالة () عمء]1115ء020011ه56: ونضيف الكود الخاص بالإجراء المطلوب داخل الدالة 
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(011010مه. الإجراء المطلوب تنفيذه عند النقر على الزر هو تعديل النص المعروض في عنصر 
الواجهة سwع۷¡i)×ء1رم‏ ليصبح "0011010 ."Butt0on‏ لتنفيذ هذا الإجراء يتم أولاً الوصول العنصر 
ny rext View‏ باستخدام الدالة ()512017161833/101» ثم نعدل النص المعروض بتنفيذ الدالة ()×ع1)ع؟. 


التعامل مع الحدث عن طريقة ملف Layout‏ 


يمكن تنفيذ حدث معين عند النقر على الزر بطريقة أخرى وذلك بتعديل ملف هيكلية الواجهة 1330106 بإضافة 
الخاصية 1ع200010:02011 وإعطائها قيمة تمثل اسم الدالة التي سيتم تنفيذها تلقائياً عن النقر على الزر كما هو 
موضح في المثال التالي: 
1 81 > 
AO Ct SA /MYEUE E O L‏ د ان اديت امات 

COM ESR‏ كد سن :ع LE VOUE WIC‏ ك1 2ت منك لت 
AEE EOS ES VO E Me OS IES ESS COM ECEME‏ 

AMEE OG E ES OE COME CE 1ت 02ت 12 سات‎ E EE 

VME EGA L> "1‏ عدت 2 11ت laVOUE‏ 2 14ت تلك للك 

SE EMO‏ القت 1906 ل ركان 8 قم E>‏ رمت 618 در 6ر01 رات 
android:onClick="myButtonClicked" />‏ 


بعد تعديل ملف الواجهةء يجب التعديل في ملف الفعالية (17167ع4) بإضافة الدالة | myButt0»٣ 11c)‏ كما هو 
موضح بالمثال التالي: (يجب أن يكون اسم الدالة مطابق للإسم المحدد في ملف .(Layout‏ 


public void myButtonClicked (View view) { 
TextView myTextView = (TextView) 

FIRAT سيت‎ VIG (RTE MYLEX EVI eW) ; 
myTextView.setText ("Button clicked"); 

} 


ملاحظة: يفضل استخدام الطريقة الأولى للاستماع لأحداث عناصر الواجهة وهي بإضافة المستمع (إعع)ء¡) 
برمجياً وذلك لأنها تسمح بلاستماع لأحداث متنوعة عن طريقة دوال مختلفة «setOnClickListener )( Jû‏ 
set 0n ouchاistener )( ءsetOnLongClickListener Û)‏ وغيرها. كما أن هذه الطريقة تضمن فصل 


كامل ما بين مرحلة تصميم الواجهةء وهو ما يتم من خلال ملف هيكلية الواجهة» وبين مرحلة التعامل مع الأحداث 
والذي يتم برمجياً من خلال الفعالية (16كناعة). 


في النهاية» نستعرض بعد مستمعات الأحدات (18همه1.15]6 6مه817) التي توفرها عناصر الواجهة والتي يمكن 
استخدامها للاستماع لأنواع مختلمة من الأحداث» ومن ضمنها: 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


ه 115]6261ك00001101: ويستخدم لتنفيذ إجراء عند النقر ثم ترك عنصر الواجهة سم۷1. يتم كتابة كود الإجراء 
في الدالة ()16ع2)011ه. 


«ه “لعمءاور1كاهنان)عمه.1[هه: ويستخدم لتنفيذ إجراء عند النقر لفترة على عنصر الواجهة. يتم كتابة كود 
الإجراء في الدالة ()1[ء021028)0011. 


» Keyistenerده:‏ ويستخدم لتنفيذ إجراء عند الضعط على أحد المفاتيح في الجهاز بينما عنصر الواجهة 
677 مفعّل من قبل المستخدم (15اء50 35]). يتم كتابة كود الإجراء في الدالة ()/021©3. 


تمرين عملي (3-2) 


يتطرق هذا التمرين إلى عناصر واجهة متنوعة مثل زر الإنتقاء (2)19201081]00 خانة الإختيار 
»)€checkB0x(‏ القائمة المنسدلة (إع«مم؟) والشريط المنزلق (1ه1188ع96) وكيفية معالجة الأحداث لهذه 
العناصر برمجياً وأنواع المستمعات (658م15]6.]) المختلفة لهذا الغرض. الواجهة الخاصة بهذا التطبيق وأنواع 
القاضر المضافة موضحة فى ككل 32 


Where do you study? 


Radio Buttons © uocas 
O IUGAZA 
What languages can you speak? 
Check Boxes Û English 
Arabic 
Spinner Where are you from? 
Palestine 
Rate your level of happieness 
Seek Bar م‎ 
50 
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لتحديد مصفوفة النصوص (61138/ ع512) التي يجب تعبئتها في القائمة المنزلقة (61مم1م5)»: أضف المصفوفة 
countries_array‏ إلى ملف وع 1و كما هو موضح بالاسفل: 


ML eS OM LN OL ادك مك رت‎ > UE E 6 د‎ 

Se SOUL CES 2 

<string name="app_ name">UIl Events</string> 
<string name="action settings">Settings</string> 
CSE EMG ست‎ EA Mame sl تاس مت‎ TES GEES 
<item>Palestine</item> 

<item>Egypt</item> 

<item>Algeria</item> 

<item>Syria</item> 

<item>Jordan</item> 

<item>Saudi Arabia</item> 
<item>Iraq</item> 

</string-array> 

</resources> 


ملف تصميم الواجهة اuمره]‏ الخاصة بهذا التمرين موضح بالأسفل: 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android"™ 
Sm mS EOL لت 5 / / : 665 1 2ه‎ 2112-5 7 212616 O GA COM EOL SL 
AMA EOS الاكان 1 د‎ 4 A Ba me 1ر1 1ق‎ 
aE OES EA ODE EE MS MA EER تم‎ Ee E 
تلك لت‎ OMG SA OU E Me O MES MA ECEM AEE EL 
android:orientation="vertical"™ 
android:paddingBottom="@Gdimen/activity_vertical_ margin" 
android:paddingLeft="@Gdimen/activity_ horizontal _ margin" 


android:paddingRight="@dimen/activity_ horizontal margin" 
6ن 1ه‎ OLO ECE كر‎ CE MER ACEI WEE LLEENL_ Me CG LM 
tools:context="com.example.uievents.MainActivity" > 
<TextView 
android:id="@+id/studyTextView" 
AA EOE SAO E EGE MS AS COM EEN E 
AEE eG 1121575 E ES ES ESS COM ECEME 
AMCEOLCE LAVOUE_ كم و52‎ 
android: text="Where do you study?" /> 
<RadioGroup 


رك الكلية الجامعية للعلوم التطبيقية 
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android:id="@+id/radioGroup™" 

AMEE OG E E OE GSE MS TS COME CME 

AMEE 18م ادهو‎ A OE MEE MES EA COME ERE E 
Sal SSE U EEO 


android:id="@+id/ucasRadio" 
ARE HOG 2 EA VO E EGE MS ES COM EEN E 
:10ت عذك لت‎ 11210116 Me HOMIES MESS COM ECEME 
android: text="UCAS" /> 
>12 611-615 MEE ON 
android:id="@+id/iugRadio" 
كملع له _ 1165761015 621615 12امامنة‎ AS COM EEN E 
18ت 120! :161 تك 1ك لت‎ EOE كشن‎ CON EEN E 
352012010: "162252"-غ22عغ‎ /> 
</RadioGroup> 
<TextView 
android:id="@+id/languageTextView" 
تدك له‎ 0 114 2 laVOUE Mar OM LOPS Op Il 
ARE EOE SA VO E EGE MS EA COM EEN E 
عذك رلك‎ GS A OME 15 O MES WIESE COM ECEME 
android:text="What languages can you speak?" /> 
<LinearLayout 
311701 02124: la yOu E id Ma FEM Pa lem 
amo NG E a VOUE MeO MES ES COME El 
SESE OMEN E E 2 6 HOM VEREN CO 
<CheckBox 
android:id="@+id/englishCheckBox" 
ادهو قامدرة‎ E EE OE RG E MS ES COME CME 
AMEE OEE ال‎ 256135 ME OS MES ES COME CME 
AME 51618 در ات واكم تكن‎ 
<CheckBox 
android:id="@+id/arabicCheckBox" 
EMCEE E LE OU WAC EES _ COM ESR 
3ME EON 1: 1121 12ت‎ MOMS MES ES COR EEE 
11ت 0118 17ت‎ GAS EEE > LAA 
</LinearLayout> 
<TextView 
AO EOE A اك‎ "00 526 ACO EE VARESE A e 
تدك جلت‎ eG A VOU E MS ESERO O 
:1ت عذلك لت‎ Le OU _ WAC LACES COMES 
ةسامسة‎ 1161 113561115 REME DES ES COME EME 
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57056110: تع‎ EL 1525ل‎ 225 YOU 22525 م‎ 
<Spinner 
AMO ESCA ES CF MA ACO SURE LEE SSAC E 
android:layout_ width="match parent" 
تت 12ت 121 11 هك 1ك لت‎ MES ES CON ECEME 
android:entries="@array/countries_array™ 
> 
<TextView 
android:id="@+id/happienessTextView" 
تك لله‎ 01-0: layOUE Mar OAM مت‎ Op Il 
لك :كت 1ك تنك ملت‎ 21118 EG E MS كد سن‎ COM EER E 
مامد‎ 6:21 SA VOM E ME OES ESO COR EEN E 
ARIFO SEEexXE- Rae YOUE level Of 25251555" > 
<SEeKBa E 
android:id="@+id/happienessSeekBar" 
311701 0214: la yOUE ك2‎ RM Ma leM ست دم‎ 
android: layout_height="wrap_ content" /> 
<TextView 
android:id="@+id/HappienessValue" 
مزه لت‎ 3 11 LAVOE WAGERS TEAS COMES 
AREA EOE E !121 12ت‎ MEO MES HES COME EME 
1ك له‎ 170: AVOUE CES E Y> Ce MIEEe Ell 
16ت‎ 112 EEE 
> / 11232137011 < 


لاحظ أن أز راء الانتقاء و8060 112010 تم جمعها في مجموعة واحدة م120100101 وذلك حتى يتم اختيار 
عنصر واحد منها فقط. لاحظ أيضاً القائمة 1061م وكيف تم تعبئتها بالمصفوفة المحددة مسبقاً في المصادر 
(ملف 1 ×.ئعہ ناء ( وذلك باستخدام الخاصية android:entries=" © array/countries_array"‏ (يمكن 
تعبئة القائمة spinner‏ برمجياً باستخدام المحول Adapter.‏ والذي سیتم الحديث عنه لاحقاً في هذا الفصل). في 
أسفل الواجهة تم استخدام عنصر عرض 762]5/16 وذلك لعرض القيمة الراجعة من العنصر ه13 [566. بعد 
تجهيز الواجهة» سيتم الآن معالجة أحداثها برمجياً داخل الفعالية (لراز۷ ام4 1ةN)‏ كما هو موضح: 


PUC IE CESS MIRAGE ENE كح ع كدت‎ 5 LCE EVN EY 


@GOverride 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
SEE CORMIER EE E AOE 2 EE AT EAM AA 


} 


O OO IAS 0 ذا دن كنم‎ ] 


4 0576 1116 


رك الكلية الجامعية للعلوم التطبيقية 
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0 6ت 5ت 2ك لت ات 6 عم MOE‏ 
SEA EOE‏ كك SHPO EE‏ 11 
RadioGroup radioGroup = (RadioGroup)‏ 2 
OC FOU)‏ 1ك 22 TEWE VISA KRE‏ بلك ET SE END‏ :5 
radioGroup.setOnCheckedChangeListener (new‏ :14 
SE android.widget.RadioGroup.OnCheckedChangeLlistener )( {‏ 
1O8‏ 
@GOverride‏ 8 
public void onCheckedChanged (RadioGroup Group, int‏ 8 
checkedId) 1‏ 98 1 
(checkedId == R.id.ucasRadio)‏ 11 20 
| () 2ت LI CAE 1 OREOR E‏ م فرك ع 2l TOA SE make Rex E (SE‏ 
UCAS MOSSE ENEMA SHOR ESO O‏ 5 551635 228 
else if (checkedId == R.id.iugRadio)‏ :23 
O,‏ عدت 6 10116611 2 1-62 لل E. make lex E (Ge EADP‏ 5 3 179 :24 
MUG, MOSSE LEE TEA SHORE SRO OE‏ 5 61635و :25 
} 208 
A8. PUR‏ 
CheckBox englishCheckBox = (CheckBox)‏ :28 
OSS)‏ 2ت 61202 5 ا (RHE ENGL‏ لكل 20S EMS AMO UN EWEY‏ 
englishCheckBox.setOnCheckedChangeListener (new‏ 30 
o OnCheckedChangeListener () {‏ 
@GOverride‏ 32 
public void onCheckedChanged (CompoundButton‏ 39 
buttonView, boolean isChecked) {‏ 54 
Toast.makeText (getApplicationContext )( ,‏ :355 
ات OME EO VLE. GE ELE O 15 LS‏ :36 
NS Roa Ss E RENEE SHORT ESO OE‏ 
) :55 
اب 398 
CheckBox arabicCheckBox = (CheckBox)‏ :40 
TE 2 2 21-2 (CRNECKEOS‏ 1) كر عبات ERIS EARS‏ :1ك 
arabicCheckBox.setOnCheckedChangeListener (new‏ :42 
OnCheckedChangeListener )( {‏ :43 
@GOverride‏ :44 
public void onCheckedChanged (CompoundButton‏ :45 
buttonView, boolean isChecked) 1‏ :465 
:47 
Toast.makeText (getApplicationContext )( ,‏ :45 
E DL OS 1 MOCO ESKE,‏ رك ته DEE OR VE‏ 400 
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Toast. LENGTH SHORT) . 51077 )( : 


(Spinner) 


NF 


Spinner spinner 


EAL So E LACVLESVIG! (Ro LO. COUR Ê 1 EOS متسس هرو‎ £ 
spinner.setOnItemSelectedListener (new 
OnlItemSelectedListener )( { 


GOverride 


public void onltemSelected (AdapterVview<?2> parent, 
Mew UE, AME POSTEO, ONS AO 
Toast.makeText (getApplicationContext )( , 
11ت كل اك كل‎ E Ie EN EeMAEEOSN ELON (POS ع لك‎ 2 OR) CEOS عدع‎ 2229 )( | 
Toast. LENGTH SHORT) . 511077 )( : 


} 


@GOverride 
public void onNothingSelected (AdapterView<?2> 
parent) {} 

PJ? 

final TextView happienessValue = (TextView) 


this.findViewById(R.id.HappienessValue) ; 


(SeekBar) 


SeekBar seekBar 


this.findViewById(R.id.happienessSeekBar) ; 
seekBar.setOnSeekBarChangeListener (new 
OnSeekBarChangeListener () { 


80775 16 


public void onProgressChanged (SeekBar seekBar, int 
progress, boolean fromUser) { 
happienessValue.setText (String. valueOf (progress)); 


} 


64 01766 


public void onStartTrackingTouch (SeekBar seekBar) {} 


public void onStopTrackingTouch (SeekBar seekBar) {} 


60761116 


N 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


يتم معالجة الأحداث لكل عنصر كما يلي: 


ه :Radio Buttons‏ لتحديد أي زر إنتقاء (81600 122010) تم اختياره» نقوم باستخدام المستمع 
RadioGroup.OnCheckedChangeListener‏ وإضافته إلى مجموعة الأزرار م1201 230106 (أنظر 
سطر رقم 14). عند حصول الحدث يتم تنفيذ الدالة ()04 020061600023286 والتي يمرر إليها رقم المعرف 
0 الخاص بالزر الذي تم اختياره حيث يتم طباعة رسالة تبين الإختيار (أنظر الكود من سطر 18 إلى 26). 


Boxes‏ علءعط0): للاستماع لحدث اختيار مربع الإختيار (×80)ءمط٣)‏ نستخدم المستمع 
عه مآءع طهط لع 1ءعع 20 20810100.0ناوم ده" (أنظر سطور رقم 30 و 42)» وعند حصول 
الحدث يتم تنفيذ الدالة ()020601260022860 والتي يمرر إليها الكائن الخاص بمربع الإختياربالإضافة 
إلى قيمته (06-42156) حيث يتم طباعة اسم مربع الاختيار وقيمته (أنظر الكود من سطر 33 إلى 38» ومن 
سطر 45 إلى 51). 


»ه :Spinner‏ نستخدم مستمع من نوع apterView.OnitemSelectedListener‏ لمعالجة الحدث الخاص 
بهذا العنصر (أنظر سطر رقم 56). عند حصول الحدث يتم تنفيذ الدالة ()0 08011611961616 والتي من ضمن 
مايمرر لها موقع العنصر الذي تم اختياره من القائمة. بمعرفة موقع العنصر يمكن الوصول له من القائمة عن 
طريق الدالة ()0)زوه20)خشددة]]]عع (أنظر الكود من سطر 60 إلى 65). 


:Seek Bar ٠‏ يتم معالجة الغيرات على الشريط المنزلق (اة8)عء5) عن طريق إضافة مستمع من نوع 
OnSeekBarChangeListener‏ (أنظر سطر رقم 74). عند حصول الحدث يتم تنفيذ الدالة 
Change)‏ ووعتنع 20م والتي يمرر لها القيمة الحالية للشريط (100-0 مثلة) بالإضافة إلى القيمة المنطقية 
1561 والتي تحدد ما إذا كان تغير الشريط تم من المستخدم (عں)=إعءêاصہf)‏ أو برمجیا 
(ع11567-14015آ60202). في المثال الموضح يتم طباعة قيمة الشريط الممررة في عنصر من نوع 2]5/1619ع1” 
(أنظر الكود من سطر 77 إلى 80). 

قائمة العرض (ListView)‏ 

عرض العناصر في قائمة هو أحد التصاميم الشائعة بكثرة في تطبيقات الهواتف النقالة. يشاهد المستخدم عدد من 

العناصر ويستطيع الانتقال لأعلى القائمة وأسفلها 117/0016 501011 كما هو موضح بشكل 3-3 . عند إختيار أحد 

عناصر القائمة یتم عادة تنفيذ إجراء مثل فتح فعالية جديدة. 

إضافة بيانات للقائمة (ListView)‏ 


لإضافة بيانات للقائمة (سع۷1†ء1) يتم عادة استخدام المحول (إعمةلA)»‏ وهو كائن وسيط بين عنصر العرض 
وهو القائمة (15]9/167]) (أو أي عنصر واجهة يتفرع من الفئة 1355 سعذ۷إممهل۸A)‏ وبين البيانات 
المعروضة. يتحكم المحول (إعامهل۸) في الوصول لبيانات القائمة» كما أنه مسؤول عن تحويل البيانات المدخلة 
للقائمة إلى عنصر عرض (17167) يمكن تضمينه داخل القائمة. فمثلاً» عند إداخل مصفوفة من النصوص (1123/ 
عStrin)‏ لعرضها في القائمة» يقوم المحول (167م402) بتحويل كل عبارة نصية في المصفوفة إلى كائن من نوع 
(16]971617) والذي يتم إدراجه في القائمة» أي أن مصفوفة النصوص تتحول باستخدام المحول (إعامهل۸) إلى 
مجموعة من عناصر العرض (/16]1/1607) المجمعة في قائمة من نوع (/15]7/1617.]آ). 
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اليه عنوان الكتاب 
رقم المقرر 


شكل 3-3 : قائمة العرض (1.15]571609]) 1 


لاحظ أن محتوى القائمة قد يكون أكثر تعقيداً من مجرد عرض عبارات نصية. على سبيل المثال» قد يشتمل السطر 
الواحف فى القائيةا على صورة وتن دزن فى هذه الخال بحب تصغيم فيكلية الواجية التخاسة بالسظر الواحد 
كملف 12300106» ومن ثم نقوم بكتابة محول خاص (1617م03 0115]022) والذي يقوم باستقبال البيانات» الصور 
والنصوصء وإنشاء عنصر العرض (9/160) لعرضها بناءً على ملف امره[. سنقوم لاحقاً في هذه الوحدة بتناول 
موضوع المحولات الخاصة .(Custom Adapter)‏ 


(Default Adapter) المحولات الافتراضية‎ 


يوفر نظام أندرويد بعض المحولات الافتراضية» من أهمها امھ ArrayAd‏ و .CursorAdapter‏ يستخدم 
Array Adapter‏ لإدراجات البيانات الموجودة في مصفوفة 4129 أو او11.المحول المخصص 
(167م0115002) يعالج البيانات المدخلة من قاعدة بيانات أو مزود المحتوى (210171061 02]06©). کل هذه 
المحولات 15ع]م402 هي فئات فرعية (و50512556) من الفئة الأساسية إieاBaseAdap.‏ 


تمرين عملي (3-3) 


يوضح هذا التمرين استخدام ArrayAdapter‏ لتعبئة قائمة العرض (ListView)‏ بمصفوفة من العبارات النصية. 
1301 يتعامل مع مصفوفة من الكائنات واءعزاه حيث أن كل كائن سيمثل كسطر في القائمة 
.(ListView)‏ 


Using Lists in Android, atutorial by Lars Vogel, ' 
http://www. vo gella.com/tutorials/AndroidListView/article.html 
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الكلية الجامعية للعلوم التطبيقية 


في هذا التمرين سنقوم بتعبئة قائمة (سع1۷1ء11) باسماء مدن فلسطينية كما هو موضح في شكلء وعند النقر على 
أي اسم يتم معالجة الحدث بطباعة رسالة على الشاشة. 


HEYETI TET ال‎ 
Jerusalem 
Gaza 
Ramallah 
Jenin 
Nablus 
Tulkarm 
Al-khalil 
Haifa 
Yafa 


Areeha 


شكل 3-4 : واجهة التطبيق الخاصة بالتمرين 3-3 


ملف هيكلية الواجهة (133006) الخاص بالبرنامج موضح بالأسفل»ء حيث تحتوي الواجهة على عنصر واحد فقط 
وهو القائمة (wع¡is†V):‏ 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
155ل د‎ SIE OO SME EB 2//SCMeMma SARO EON GA. COM EOC SL 
android:id="@+id/LinearLayout1"™ 
AMA EOE E E MOE GE MS ma EE Rae E 
amdrEO GQ: 1152570165 Mer OME> I MalECEM alen El 
AREA EOE OEM EM E 2 6 4 لات‎ > ١: عدت‎ EA CAL 
tools:context="com.example.simplelist.MainActivity" > 
<ListView 
android:id="@+id/listView" 
AME EOE E HE OE GE MS ma Ee MOA eM E 
تدك لك‎ 174: 11250165 Men GOMES IEA COMEENEL > 
</ListView> 
</LinearLayout> 
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الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


الكود الخاص بالفعالية 1131420115716 موضح في الأسفل: 


ع AEN‏ 5ك ست 6 عدت EY‏ ل ب عات 2 2 2-55 للك NE BUBE‏ 

2: 

35: @GOverride 

4: protected void onCreate (Bundle savedInstanceState) { 
5: super.onCreate ) 5 3701251322653 ( م‎ 

6 SEE 8 كت 6 10ت‎ EVE (Ra YOU aC UE MA AM) 

2 ListView listView = (ListView) 

OS EMIS . 2 15 لك ل نظت لد ك‎ (RTE. لك‎ 11-5 EV CW) 

9: SEMO l Values — (VE 25317 EAA, 

10:; "Ramallah", "Jenin", "Nablus", "Tuülkarm", "Al= 

1l: Khalil", "Haifa", "Yafa", "AreelhaTt; 

2 ArrayList<String> listValues = new 

LSS AEKAVLLSLS OEE م )( << رمهنة‎ 

14: OE (AME dO; GAMES IERIE A) 

oe listValues.add (values [i)]); 

108 ArrayAdapter<String> adapter = new 

17: ArrayAdapter<String> (this, 

155 AMES REA OIE SALE SE eem U SANE) 2 
1 98 listView.setAdapter (adapter) م‎ 

202 listView.setOnItemClickLlListener (new 

21 Om 5 ركست عاك 1ه شعت 51 76ت‎ )( ١ 

22: 

25: @GOverride 

24: public void onltemClick (AdapterView<?2> 
كك‎ BARE E, VANEN AEN ANE COS EMO, OME O) |! 

26 1103 5 E ma kele xt (Ge لل مر فرك ع‎ 1-62 2 1 OREOR Ee XE (J, 
2N: PoFEeME. GEE عا نك 5 © جع شروت ع اا‎ ION (POSE EN OM) CEOS EADS )( | 

255 ROSS E HENGE SHOR) هامح‎ OE 

20 / 

م 310 

3 } 

3258 J 


لتعبئة قائمة العرض (سء۷1اء11) يتم تنفيذ الخطوات التالية: يتم أولاً الوصول للقائمة عن طريقة الدالة 
1ViewBy10‏ م (أنظر سطر 7 و 8)» ثم نقول بإنشاء مصفوفة (1.156) تحتوي على أسماء المدن المراد 
إضافتها للقائمة (أنظر السطور من 9 إلى 15). لإدراج محتويات المصفوفة (1156]) في قائمة العرض 
(1.15]17/1619]) نستخدم ع)مھd A‏ yھA۲r‏ ويتم إنشاءه كالتالي: 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


ArrayAdapter<String> adapter = new 
ArrayAdapter<String> (this, 
مامسة‎ OLO Ko LAVOE .S1mMSle 12155 item 1, 11551 ¢ 


حيث يمرر له ثلاث قيم هي: )ه0026 (الفعالية الحالية)» المعرف الخاص بتصميم هيكلية الواجهة 
(1_تطعغ5)_1ناآ_ءع1مدطذ04.5ه:0011010.15.1353)» وقائمة البيانات (115]721065). تحتاج قائمة العرض 
(115]9/1617) إلى تصميم يحدد كيفية عرض كل سطر وخصائص العرض (التنسيق والهوامش والخطوط وغيره 
من الخصائص). يمكن تصميم شكل السطر في القائمة في ملف 1,3300106 مستقل» ومن ثم تمريره للمحول 
(161م403) عند إنشائه. في هذا التمرين» تم تمرير أحد التصميمات الافتراضية التي توفرها بيئة أندرويد والتي 
تحمل الصيغة :<301010.185.1337:011].>1335:0116_1223106 . هناك المزيد من التصميمات والتي يمكن تجربتها 
وملاحظة التغير في شكل القائمة (سwع۷1ءi¡).‏ 


بعد إنشاء المحول (Adapter)‏ وإدخال البيانات إليه نقوم بتمريره إلى القائمة (ListView)‏ عن طريق الدالة 
set Adapter)‏ من خلال (/115]9/16) (أنظر سطر رقم 19). كما ذكرنا مسبقا فإنه المحول (17ع1م402) يقوم 
بتحويل البيانات المدخلة إلى عناصر 7716175 ومن ثم تجميعها وعرضها في القائمة (1.15]7/1619آ). 

لمعالجة حدث النقر على أي عنصر من القائمة» قمنا بإضافة مستمع (Listener)‏ من نوع 
]111 (أنظر سطر رقم 20). عند حصول الحدث يتم تنفيذ الدالة (00ع02166500111 والتي 
يمرر إليها موقع العنصر الذي تم اختياره من القائمة .(ListView)‏ يتم بعد ذلك الوصول و طباعة اسم العنصر 
الذي تم اختياره عن طريق الدالة ()1462051102مع:]1]عع (أنظر الكود من سطر 24 إلى 31). 

لاحظ أن البيانات التي يتم تمريرها إلى المحول (17ع]م43) قد لا تكون بيانات نصية ع«ذ)؟» بل قد تكون كائن 
(0ءز06) من أي نوع. في حالة تمرير كائن غير نصيء يقوم المحول (Adapter)‏ ضمنيا بتنفيذ الدالة 
Str .0‏ ) لتمثيل الكائن كنص. لذلك احرص على تطبيق الدالة 0)عم1ء5مه لاي كائن تقوم بإنشائه حتى تعمل 
القائمة (سwع۷1ء1])‏ بعرض البيانات بالشكل الصحيح. 

القائمة عن طريق الدالة 1)0 ل0 Mءء1هط‏ ٤ءء‏ بتنفيذ الأمر التالي: 


م 1101:1112 TEWE 58 106 1-116 ESE VTE E CHOKEE MODE‏ 115 ال 
كما يوفر نظام أندرويد تصماميم افتراضية للقوائم متعددة الإختيار ‏ مثل 


e_list_item_multiple_choiceاlayout.simp.‏ ndro1.Rه‏ والتي يمكن تمريرها للمحول كما فعلنا في 
التمرين السابقء حيث تصبح واجهة التطبيق السابق عن تطبيق خاصية الاختيار المتعدد كما بالشكل 
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Jerusalem 


Gaza 


لا 
0 


Ramallah 


Jenin 


ÛJ‏ كه 


Nablus 


Tulkarm 


3 


AIl-khalil 


ÛJ‏ كم 


Haifa 


Yafa 


Û‏ لا 


Areeha 


شكل 3-5 : الاختيار المتعدد من القائمة (57197)و1.1]) 


الجدير بالذكر أن نظام أندرويد يوفر فئة ووه[ باسم 1.15]42191697» وهي فعالية ذو واجهة مستخدم إفتراضية 
تحتوي على قائمة (سع۷1]ء1). في حالة استخدام /1.15]400111] بدلا من 17167]عكر» لن تحتاج إلى تصميم ملف 
واجهة للتطبيق وإدراج قائمة جديدة (115]9716) » حيث يمكن الوصول إلى القائمة (سع۷1]ء11) الموجودة 
افتراضياً في الفعالية ty‏ 141ء11 عن طريقة الدالة () .ListActivity.geLis View‏ 


Custom Adapter المحول الخاص‎ 


المحول الإفتراضي ]611330402 يوفر فقط إمكانية إضافة العناصر النصية من نوع ع30خ5»: وأي بيانات من 
نوع آخر يتم تمريرها للمحول ,ع]م802:إ6112, يتم تحويلها تلقائياً نص عن طريق الدالة ()ع60510. في كثير 
من الأحيان تحتاج لإضافة أنواع أخرى من البيانات للقائمة (115]9/1617) مثل الصور. كذلك قد يكون السطر 
الواحد في القائمة مركباً حيث يتكون من أكثر من جزء كما هو موضح في الهيكلية الموضحة في شكل 3-6. 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 

للم وو ا ككم ار 
aa n‏ 
1١-9‏ 0 '* 1 لسر 
ا 
E ea]‏ 


شكل 3-6 : قائمة عرض (115]171677) حيث أن تصميم السطر يكون مركباً من مجموعة من العناصر' 


في مثل هذه الحالات» نحتاج لإنشاء محول خاص (إعامةل۸A‏ 7زه]05©) نحدد فيه تصميم الواجهة الخاصة 
بالسطر في قائمة العرض (15]516])» ونحدد كذلك كيف يتم معالجة البيانات المختلفة لعرضها في سطر القائمة. 
للقيام بذلك نقوم بإنشاء فئة (012585) جديدة تمثل المحول الجديد بحيث تتفرع من الفئة ع1م 8356402 أو أي فئة 
متفرعة من عام AdaءBas‏ مثل ,ع]م139400ىء ثم نقوم بتطبيق الدالة ()9/1687]مع والتي يتم من خلالها 
إنشاء الواجهة الخاصة بالسطر. وغرضن البيانات في عناضرها, التمرين. الثالي. يوضيح خطوات ينام واستتخدام 
المحول الخاص (1ع]م03 20ه0015]0)) ضمن تطبيق بسيط. 


في هذا التمرين سيتم استخدام القائمة (1.15]77168) بالإضافة لمحول خاص (61]م402 005]050)) لإنشاء واجهة 


التطبيق الموضحة بالشكل 3-7 : حيث تتكون الواجهة من قائمة (1.15]5/1617) كل سطر فيها من مكون اسم شخص 


Using lists in Android, A tutorial by Lars Vogel, ' 
http://www. vo gella.com/tutorials/AndroidListView/article.html 
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Fadi 


lbrahim 


Hani 


Wael 


Saleem 


Hatem 


OOUOO 


شكل 3-7: واجهة التطبيق الخاص بالتمرين 3-4 


يتم في البداية تصميم واجهة السطر والتي تتكون من عنصر لعرض الصورة 101386171618 بالإضافة لعنصر 
نصي 162]17167' لعرض الإسم. الملف التالي 01ك.4ل310/0ا_للاء1/اؤؤذا_لام يوضح تصميم هيكلية الواجهة. 


GMM  ترع كنك ك كرت 017 :1ك لكت ده‎ - 8212 GU د‎ 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
AME EOE LE MOE GE RS ma EE RBA Ge E 
تك لله‎ 014: 11517016 Mer OME 11 لت‎ alen El 
110 لدت عات‎ O HOE لت‎ E 2 ات 8 ا‎ >MORE 2 عت‎ aA > 
> 111301717 
android:id="@+id/imageView" 
:1ه ملك لت‎ EA OE EE MS OIE 
MOE 511615 LAVOUE_ MELEE = OCC 
android:src="@drawable/ic launcher" /> 
<TextView 
1ك مك مات‎ E AOE OTIC ECO EVIE 
14ت تدك لت‎ Sa YOU E Wi dE MS Male Oa لس‎ 
aREEOMG 1110 Me ORES 440l 
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عنوان الكتاب 
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Ze > 22S‏ 5 2 درك يا : ك للدت كك 15ت 

OME EES EY e > BOL‏ ملكت جلت 

ARMOEOLES LAVOE MEEGARLE E1 06 

E OE SE E SN CCIM EES VICE CE AL‏ 61 اده قرام سه 
</LinearLayout>‏ 


بعد ذلك يتم إنشاء المحول الخاص (إعامةلA‏ 71ه00154)) والذي سيستخدم في الواجهة في الشكل 3-7 تصميمها 
لبناء القائمة (سع1ا۷ء1]). الكود الموضح بالاأسفل يوضح الفئة (01355) الخاصة بالمحول الخاص (15]020'© 


:(Adapter 
ME كام‎ 111 Class MYCOUSEOMAGAPEeE extendas 
2: ArrayAdapter<String>{ 
9 COM EEE COR ECE, 
4: List<String> names; 
5: List<Integer> photos; 
6 
0 حا كرات ك ضكرت 6 111704105 16ل وناك‎ CE ) 4 عدت 5ت‎ COMECSE, ده‎ 5 6 >95 2 2 9 
8: names, List<Integer> photos) { 
58 SUBE E (COR EEE, E avo my MS Ee AMO, 
10: names); 
و‎ this.names = names; 
2 ERN SEEPROEOS =< 5255255-57 
I: EMS COM EEX E > 25152267 
AE } 
52 
16: public View getView (int position, View view, ViewGroup 
17: parent) { 
19 1f (view == null) { 
19ٍ LayoutInflater inflater = (LayoutInflater) 
2U 26215 16ت‎ OC ESMS 2 210521 VU CE ( 
21-5 COME ESE EL MO UE _ 118 EAT EE 1117 1 م ا‎ 
228 view = 
OE عع 2112 7ل‎ E CS EE طن‎ AOU E MY SE E ES VOU EF BAEC E, 
24: 631 5( : 
25 TextView اخ‎ = (TextView) 
265: 71217 7 EIMGVIEWEBVIGA (RTA EEC EVN eW LD), 
2 ImageView iv = (ImageView) 
28: vVlew.fINQAVieWBYLGA (R. 1Q. imadgevi ewl) ; 
29 EV. Se 6 12 كدت‎ (Mame SOC E (EOS EOD) J 
80 iv. 5 6ت‎ IMAJeE e SOU ECE (BEAOEOS 1 6216 (EOS 12619221 J 
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0 
ViewHolder vh = new ViewHolder ();‏ 35 
vA. EOE = TUF‏ 358 
vh.image = iv;‏ 34 
view.setTag (vh);‏ 35 
الك | 36 
ViewHolder vh = (ViewHolder) view.getTag();‏ 37 
vh.text.setText (names.get (position) );‏ 358 
IE‏ 
vh.image.setImageResource (photos.get (position) );‏ :40 
1 :41 
FEE IER VIEW‏ : 42 
} :43 
:44 
45E 7 5162515 ClO SS Ve O LAO !‏ 
RESEN EOE;‏ كر :46 
A: public ImageVview image;‏ 
} :48 
}:49 


كما تلاحظ فإن الفئة الجديدة إعامa My٣usto "Ad‏ متفرعة من الفئة إعامهل۸A,ه٣]A‏ وتقوم بتطبيق الدالة 
.getView()‏ 


من خلال الباني (01]ء1ؤومه©) (أنظر السطور من رقم 7 إلى 14) يتم تمرير الكائن )×عامهء (الفعالية مثلأ)» 
والمصفوفة الخاصة بالأسماء المراد عرضها (5و031206) ثم مصفوفة الصور (photos)‏ ممثلة بأرقام المعرفات 
95 الخاصة بالصور. سيقوم المحول إع)مه ل باستخدام هذه البيانات في بناء عناصر القائمة (سwع۷iء1ا).‏ 
لاحظ أن المحول 1ع]م41:39803, يتطلب تمرير تصميم واجهة القائمة المعرفة ب 
R.layout.my_istview_layout‏ بالإضافة إلى قائمة من الجمل النصية عمزن5 إلى الفئة الأم 
(6161355م511)و هي :1م133:403 حم » وهو ما يتم من خلال الأمر التالي في الباني :01]ع1ماكدم©: 


SUPE (SOR ECE رع‎ ES E SOME My RS E THE E MOE 7 


الدالة الأساسية في المحول (إمامهلA)‏ هي 0سء۷1]ءع (أنظر سطر رقم 16) والتي تحدد طريقة تحويل البيانات 
لكل سطر إلى عنصر عرض س۷1 ليكون ضمن القائمة (سع۷1]ء¡). لاحظ أنه يتم استخدام كائن من نوع 
111 لتحويل الواجهة الممثلة بملف ,5711 إلى كائن نوع سع۷1. يمرر إلى الدالة ()1011266 
المعرف الخاص بالواجهة المنشئة مسبقاً (10.133/010].0'_115]9161_139:0000) لتقوم بإرجاع كائن من نوع 
6197 (أنظر الكود من سطر 18 إلى 24). 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


يشتمل الكائن 57167 داخله على عناصر الواجهة وهي 10128617165 و سع۷1]×ع1. يتم بعد ذلك الوصول لكل 
من هذه العناصر عن طريق تنفيذ الدالة 81000 سwء1‏ ۴1,4۷ على نطاق الكائن 771677 (أنظر الكود من سطر 25 
إلى 28). 


TextView tv = (TextView) view.findViewById(R.id.textViewl); 
ImageView iv = (ImageView) 
view.findViewById(R.id.imageViewl); 


بعد الوصول إلى عناصر السطر في القائمة (1.15]9/160)» يتم إضافة البيانات إليه (أنظر سطر رقم 29 و30). 
الدالة ()سء۷1)ءع يتم تنفيذها لكل سطر في القائمة (115]771617)» وعند تنفيذها لأي سطر يمرر إليها رقم هذا 
السطر في المتغير00510. فمثلاً» لعرض السطر الأول في القائمة يتم تنفيذ الدالة ()٠5/16]عع‏ تلقائيا ويمرر 
إليها 0= 051102م. لإضافة بيانات لسطر ماء نضيف البيانات الموجود في المصفوفات الخاصة بالأسماء والصور 
في المكان 00516102. على سبيل المثال السطر الثالث في القائمة (سع۷1ء1) حيث قيمة 0510م تساوي 2 
يأخذ البيانات الموجودة في المصفوفات من المكان 2. هذا يضمن أن يكون ترتيب العناصر في القائمة 
(115677167) مطابق لترتيبها في المصفوفات الخاصة بالبيانات. يتم ذلك من خلال السطرين التاليين في الكود: 


E. كدت 1 6 كات‎ (MAME SS : أت و‎ (EOS EHO) 
iv.setImageResource (photos.get (position)); 


وأخيراًء لاحظ أن الكود المرفق للمحول الخاص عام 2ل A‏ 0002© يستخدم ما يسمى ب ViewHolder Pattern‏ 
وذلك لتجنب تنفيذ الدالة )11ر8 سء1 1,1۷ والتي تستنفذ وقت قد يؤثر على سرعة عرض (سع (Lisi‏ 
وسلاسة تحريكها. تعتمد هذه الفكرة على تخزين مؤشرات لعناصر الواجهة 71607 في كائن من نوع 
1 (نظر الكود من سطر 45 إلى 48) وذلك في أول مرة يتم فيها إن شاء الواجهة باستخدام 
111161 . ثم يتم إلحاق الكائن من نوع 77160/11010161 بعنصر العرض س۷1 الخاص بالواجهة عن 
طريق الدالة «setTag()‏ وهو ما یتم من خلال الكود: 


ViewHolder vh = new ViewHolder )( م‎ 
vh.text = tv; 

vh.image = iv; 

view.setTag (vh); 


عندما يتم تنفيذ الدالة getView()‏ ثانياً (كما في حالة عمل 52011 لعرض عنصر تم عرضه مسبقاً)» فان الدالة 
getView()‏ لن تقوم بإنشاء عنصر الواجهة ثانياً باستخدام Layout Inflater‏ لأنه قد تم إنشاؤه مسبقاء حيث أن 
قيمة الكائن سع ]۷ المدخل للدالة getView()‏ لا يساوي 11111 في حالة إعادة عرض العنصر. في هذه الحالة لن 
يتم إنشاء الواجهة ثانيةء ويتم استخدام الكائن 71671101061 الملحق بعنصر الواجهة 77167 للوصول للعناصر 
6171617 و ]nageView‏ بدون الحاجة لاستخدام الدالة ()77161183/10]مع (أنظر الكود من سطر 36 إلى 
1)» وهو ما يتم من خلال الكود التالي: 


5 
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ViewHolder vh = (ViewHolder) view.getTag(); 
vh.text.setText (names.get (position) ); 
vh.image.setImageResource (photos.get (position) ); 


بعد إنشاء الفئة (ووه1ء) الخاصة المحول (إعامCustom”Ada٣My)‏ » نقوم الآن ببناء الفعالية (4119717) والتي 
سيتم من خلالها إنشاء كائن من المحول ,ع1م502.دده]749:005 وتمرير البيانات المطلوب تعبئتها في القائمة 
۷6# وهي أسماء وصور الأشخاص الكرد الثالى خاضن يذه الفعالية: 


7ع عاك كع 5 LE‏ 5ك لك عت EY‏ لائي دعاك شض ل 12 NE BUGLE CLASS‏ 

2 

3: @GOverride 

24: protected void onCreate (Bundle savedInstanceState) { 
5: super.onCreate ) 5 370125153226553 ( م‎ 

() نظ ع عات > SE‏ 1 زات 16 216 MEW‏ 12210155 0ك مدعت > 6 كد 6 
names.add ("Fadi");‏ 7 

8: names.add ("Ibrahim"); 

9: names.add ("Hani"); 

10 names.add ("Wael"); 

11 names.add ("Saleem"); 

2: names.add ("Hatem") م‎ 

OE 

2 List<Integer> photos = new ArrayList<Integer> () م‎ 
ك1‎ photos.add(R.drawable.facel); 

1060 photos.add(R.drawable.face2); 

E photos.add(R.drawable.face3); 

18 photos.add(R.drawable.face4); 

198 photos.add (R.drawable.face5S); 

20: photos.add (R.drawable. face6) ; 

2 

22 MyCustomAdapter adapter = new 

29 MyYCUSEOMAGTAPECE (EMS, Mames, 526595 2 

24: 

2 this.setListAdapter (adapter) ; 

26: this.getListView() .setOnItemClickListener (new 
2: Onl temCl ne KTS Eee E () | 

25: 

2 @GOverride 

تت ) BIBINE OMG OM 1 1 EKE‏ ارك 
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SLE: 5656052 2 ,كت‎ View UieW, IME 0ه‎ 51 6220127 IONS 1O) ! 

512 3 19-9 515 Ma KENE 2 ) 90 3 2ت 11 نل م فرك ع‎ i OREOR E CSE )( | 

OSE 7 5161 6ت‎ 15 5 ETE GEE HECE EOS 1 6 11 لزت‎ (PCOS EET ORM) : 25 ETRE )( 
34: Toast. LENGTH SHORT) .show(); 

398 } 

)م :36 

} د 

IOS J 


في الكود السابق» يتم في الدالة ()]0251621 انشاء القوائم 1.15]5 الخاص بالأسماء والصور (أنظر السطور من 6 
إلى 20) ل(لاحظ أن الصور يتم الوصول إليها باستخدام المعرفات بالصيغة: 
>e.>image_file_nameاR.drawab).‏ يجب أن تكون الصور محفوظة بنفس الأسماء في مجلد ع0125/20[1. 
لاحظ أيضاً أن الفعالية متفر عة من (1.15]4.21197147]) وهو ما يعني أننا لسنا بحاجة لتصميم واجهة خاصة بالفعالية؛ 
حيث أن الواجهة الافتراضية تشتمل على قائمة (115]9/160). يتم الوصول لهذه القائمة عن طريق الدالة 
st) Activity. get ListView Û)‏ من داخل الفعالية. 


يتم إنشاء كائن من نوع المحول زعم 715900156021603 وتمرير البيانات له» ومن ثم تمرير هذا الكائن إلى القائمة 
View (‏ istا)‏ عن طريق الدالة 0)إع امهل 1114ء (أنظر الكود من سطر 22 إلى 25). 


وفي النهاية يتم الاستماع لحدث النقر على عناصر القائمة 1156971607 عن طريق مستمع من نوع 
160111161 حيث يتم طباعة الإسم الذي تم النقر عليه (أنظر الكود من سطر 26 إلى 37). 
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أسئلة على الوحدة الثالثة 


قم بإنشاء التطبيق الوضح في الشكل التالي: يقوم المستخدم بادخال اسم المستخدم “User Name”‏ وكلمة 
المرور "23551010": وعند النقر على زر الإرسال ”16رموطن51» يتم قراءة القيم المدخلة وطباعتها على 
الشاشة باستخدام )1025. 


lı Android login 


5 6: 


EEE 


قم بإنشاء تطبيق باسم vere"‏ €0 empara)ureآ"‏ والذي يقوم بتحويل درجة الحرارة من سيليزيس 
(151105[ء0) إلى فهرنهايت (16عط[مع1طج:1) والعكس. واجهة التطبيق موضحة بالأسفل» حيث يتم إدخال درجة 
الحرارة في مربع الإدخال ومن ثم إختيار طريقة التحويل: "15ازو1آءع© 60" أو ."to Fahrenheit"‏ عند النقر 


على زر ”02111346“ يتم حساب النتيجة وطباعتها برسالة 10256. مع العلم أن التحويل يتم بناءً على 
المعادلات التالية. 


°F =°C x 9/5 +32 
°C = (CF - 32) x 09 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
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| Temperature Converter 


-02 
to Celsius 


©) to Fahrenheit 


Calculate 


3. قم بالتعديل على تمرين 4-3 كالتالي: كل سطر في قائمة العرض (1.15]5/161) يعرض صورة واسم الشخص 
بالإضافة إلى وضع الاتصال الخاص به: متصل (01106) أو غير متصل (0141106). يتم عرض الأيقونات 
الموضحة بالشكل بناء على وضع الاتصال. أوضاع الاتصال الخاصة بالمستخدمين يتم تمريرها كمصفوفة 
للمحول .Adapt‌ِِr‏ 


Fadi 


lbrahim 


قم بالتعديل على المحول ١إعامةAd٣ My٣ us)‏ المستخدم في تمرين 4-3 وذلك بعمل فئة فرعية 


(1355ءطناى) من الفئة (1ام 1 ۸ءءه8) بدلا من الفئة (1٥امة‏ ل۸ رهإإA)‏ وقم بعمل التغييرات اللازمة. تأكد 
بأن تمرين 4-3 يعمل بشكل صحيح بعد إجراء التغيير. 


الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


الوحدة الرابعة: 


الربط بين الفعاليات باستخدام الأهداف 
(Linking Activities Using Intents)‏ 

يتعلم الطالب في هذه الوحدة: 

> .مفهوم الهدف (12626) وأنواعة واستخداماته. 

”7 تشغيل فعالية (/420]1716) من فعالية أخرى. 

” التواصل بين الفعاليات وتبادل البيانات بينها. 

> .مفهوم مرشح الهدف (rع‏ )۴ 10]601) واستخداماته. 
تطبيق أندرويد قد يتكون من أكثر من فعالية (4110109)»: بحيث يتم الإنتقال من فعالية إلى أخرى أثناء استخدام 
التطبيق. فمثلاء قد تكون هناك فعالية (401197107) تعرض قائمة عرض (سع۷1ء1])» وعند اختيار أي عنصر من 
القائمة يتم تشغيل واجهة جديدة (فعالية) لعرض بيانات متعلقة بالعنصر الذي تم اختياره. في مثل هذه الحالات» يجب 
تشغيل فعالية من فعالية أخرىء وكذلك قد يلزم نقل البيانات بين الفعاليات. الربط بين الفعاليات في نظام أندرويد يتم 


باستخدام ما يسمى باعاه! أو الهدف (ترجمة حرفية). يتناول هذا الفصل مفهوم الهدف (]1167) وأنواعة 
المختلفة وطريقة تشغيل الفعاليات باستخدام (10664)» ويتم تدعيم كل هذه المفاهيم بتمارين عملية. 


(Intents) الأهداف‎ 


ال (6مع6]م1) أو الهدف هو كائن (4ع06[6) يستخدم للتواصل بين مكونات التطبيقات لطلب إجراء معين أو لتبادل 
المعلومات. يمكن تخيل الهدف بأنه رسالة يتم إرسالها إلى التطبيقات لطلب إجراء ما أو لتبادل المعلومات. هناك 
ثلاث استخدامات أساسية للهدف (Intent)‏ وهي كالتالي: 


ه تشغيل فعالية (/40119716) واستقبال النتائج منها: الفعالية تمثل واجهة من واجهات التطبيق. يمكن تشغيل فعالية 
ما عن طريق تمرير هدف (76ع]م1]) إلى الدالة ()15717)عىج)5. في هذه الحالة يحدد الهدف ()مع]10) 
الفعالية المراد تشغيلها بالإضافة لأي بيانات أخرى تحتاجها الفعالية. 


ه تشغيل خدمة (ععز۷ام‌S):‏ الخدمة (ع561010) هي مكون من مكونات تطبيق أندرويد يستخدم لتنفيذ مهام بدون 
واجهة للمستخدم» وغالباً ما تعمل الخدمة في الخلفية بدون تفاعل من المستخدم. يتم تشغيل خدمة معينة 
(عvicاSe)‏ عن طريق الدالة ()عع1571ع56065 والتي يمرر لها كائن من نوع الهدف (106626) يحدد الخدمة 
المراد تشغيلها. 


٠‏ إرسال منشور (80206250 126110761): المنشور (817020635]6) هي رسالة يتم ارسالها إلى تطبيقات مختلفة. 
على سبيل المثال» عن إعادة تشغيل الجهاز 6006 يقوم نظام أندرويد تلقائيا بارسال رسالة من نوع (06مع]10) 
وذلك لإعلام كل البرامج المعنية بحدث 6006 حتى تنفذ بناءً عليه إجراءات أخرى. أرسال المنشور 
51020351 سيتم التطرق إليه في الوحدة الثامنة. 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


أنواع الهدف (Intent Types)‏ 
هناك نوعان للهدف (06ع106)؛: وهما: 


ه الهدف الصريح (10]1606 11016م:8) :وفيه يتم تحديد المكون المراد تشغيله (فعالية )ء۸ أو خدمة 
Service‏ أو منشور 70206256). غالباً ما يتم استخدام الهدف الصريح لتشغيل مكون من مكون آخر في 
نفس التطبيق لأن الفئة (ووه1ء) الخاصة بالمكون المراد تشغيله معروفة ويمكن الوصول إليها في نطاق 
ايق الواحة. 


٠‏ الهدف المضمن Intent)‏ icitاmp]):‏ وفيه لا يتم تحديد المكون المراد تشغيله صراحةٌ ويتم تحديد نوع 
الإجراء المراد تنفيذه بدلاً من ذلك. تحديد الإجراء يُمَكّن أي مكون يتبع لأي تطبيق آخر أن ينفذ هذا الإجراء إذا 
كان مصمماً لذلك. على سبيل المثال» إذا اراد التطبيق عرض صفحة ويب معينة» يجب تشغيل فعالية 
(40197167) قادرة على عرض وتصفح الإنترنت» ويتم ذلك بتنفيذ الدالة ()5]216/421151 ويممر للدالة هدف 
مضمن يحدد فيه إجراء باسم 80110111718177 وصفحة الويب المراد فتحها (لاحظ أنه لم يحدد اسم مكون 
محدد لعرض صفحة الويب). يقوم النظام تلقائياً باختيار الفعالية الملائمة لتشغيل الإجراء المطلوب 
»))A 10 N_V] ٤W (‏ وقد تكون الفعالية الملائمة تابعة لتطبيق آخر في نفس الجهاز. 


عند إنشاء هدف صريح (101600 1101]6م28) بهدف تشغيل مكون ما فإن النظام يقوم مباشرة بتشغيل المكون 
المحدد في الهدف الصريح» أما عند إنشاء هدف مضمن (دعام] 110116م112) فإن النظام يبحث عن المكون المناسب 
لتنفيذ الإجراء المحدد في الهدف (]10]60) وذلك في كل التطبيقات الموجودة في الجهاز. إذا توافق الهدف مع تطبيق 
معين» يقوم النظام بتشغيل التطبيق الموافق ويرسل له الهدف (12]606) والذي قد يحوي بيانات أخرى لإرسالها 
للتطبيق المطلوب.عند وجود أكثر من فعالية يمكنها تنفيذ الإجراء المطلوب يقوم النظام بعرض قائمة الفعاليات حتى 
يختار المستخدم الفعالية التي يريدها. شكل 4-1 يوضح إجراءات تشغيل فعالية (8 0971697ا40) من فعالية 
(۸ 420019717 ) باستخدام هدف مضمن (26ء]10 .(Implicit‏ 


startActivity() 


1 
1 


7 


/ 5 


٦ 


onCreate() 


١ 
۷ 


شكل 4-1: إنشاء فعالية باستخدام هدف مضمن: 1- من داخل الفعالية ۸ يتم تنفيذ التعليمة () 11710 51214 
ويمرر إليها هدف مضمن يوضح الإجراء المراد تنفيذه. 2- يتقبل النظام الهدف ويبحث في كل التطبيقات في 
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الجهاز عن أي فعالية يمكنها تشغيل الإجراء المطلوب. فمثلاً. الفعالية 8 تحقق الغرضء لذلك يقوم النظام 
بتشغليها ويرسل لها الهدف. 3- عند تشغيل الفعالية 8 يتم تنفيذ الدالة ()ع01100626 حيث يمكن خلالها استقبال 
الهدف الذي ارسله النظام والذي قد يحتوي على معلومات تلزم الفعالية 1.8 


مكونات الهدف (٤ہ (1te‏ 
الهدف (106626) يحوي المعلومات اللازمة لتشغيل مكون ما وتشمل أهم هذه المعلومات ما يلي: 


ه المكون (00000266): وهو يحدد المكون الذي يجب أن يستقبل الهدف (10]676). يجب تحديد اسم المكون 
فقط عند استخدام هدف صريح «(Explicit Intent)‏ وهو ما يعني أن الهدف يجب ن يرسل فقط للمكون 
المحدد بالإسم. بدون تحديد اسم مكون يصبح الهدف مضمناً (10]624 11016م102)»: وهو ما يعني أن النظام هو 
من يحدد المكون الذي يمكنه استقبال الهدف بناءً على المعلومات الأخرى المضمنة في الهدف. لذلك إذا أردت 
تشغيل مكون محدد في تطبيقك فيجب عليك تحديد المكون من خلال هدف صريح (10]6016 11016م:18) . يجب 
الملاحظة أن تحديد المكون يعني هنا الفئة (01358) الخاصة بهذا المكون مثل الفعالية (167كتاعه). 


© الإجراء :(Action)‏ وهو جملة تحدد الإجراء المراد تنفيذه مثل عرص صفحة ويب أو الاتصال على رقم 
جوال وغيره. يتم تحديد الإجراء (10)ءA)‏ في حالة الهدف المضمن (1016026 ازءزامص!) فقطء حيث يترك 
للنظام مسؤولية إختيار المكون القادر على تنفيذ الإجراء. يمكن تحديد الإجراء الذي يستخدمه الهدف برمجيا إما 
بتمريره من خلال منشئ الباني 002511001401 الخاص بالهدف أو بتنفيذ الدالة ()(56400. هناك بعض 
الإجراءات العامة التي يتعرف عليها النظام والتي يمكن استخدامها لأعراض عامةء ومن أهم هذه الإجراءات: 


ه 80711071_7718997: والذي يستخدم لعرض بيانات معينة للمستخدم. قد تكون هذه البيانات عبارة عن 
عنوان موقع ويب أو صورة يراد عرضها أو موقع على الخريطة وغيره. 


هه :C]0N_SEND‏ وهو يستخدم لمشاركة البيانات ارسالها كبريد إلكتروني أو تحميلها على شبكة 
إجتماعية. 


٠ه‏ البيانات (a)ة0):‏ وهي عبارة عن كائن من نوع ذل يشير إلى البيانات المراد استخدامها. نوع البيانات 
المرسلة في الهدف (10]60) يعتمد على الإجراء المطلوب» فمثلا في حالة الإجراء (4011011_1718577) 
تكون البيانات على شكل عنوان الصفحة أو الصورة المراد عرضها. 


ه التصنيف (019ع026)): وهو يحدد نوع المكون الذي يتلقى الهدف (106626). في معظم الحالات لن تحتاح 
لتحديد التصنيف. من أنواع التصنيفات +[1.817701117_آ+811:601) وهو يحدد الفعالية الرئيسية التي 
سيبدأ بها تشغيل التطبيق» حيث أن كل تطبيق له فعالية واحدة فقط من هذا التصنيف. 


ه الإضافات (182085): وهو عبارة عن حافظة تستخدم لإرسال بيانات إضافية من خلال الهدف (٤معام1)»‏ 


وترسل البيانات على شكل مفاتيح وقيم مقابلة (72115 72106-ل1>69)» حيث يمكن الوصول لكل قيمة من خلال 
المفتاح المحدد لها. يتم إضافة البيانات للحافظة عن طريق الدوال من نوع .putExtra)‏ على سبيل المثالء» اذا 


Intents and Intent Filters, Android Developer, http://developer.android.com/guide/components/intents- 
filters.html 
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اردت ارسال بريد إلكتروني من خلال التطبيق» يجب انشاء هدف وتحديد الإجراء له من نوع 
(4201101_5181171). ثم يجب تحديد العنوان البريدي للمستقبل عن طريق الدالة 11]15208م وتستخدم 
المفتاح .]7711:1981 كمفتاح لبيانات المستقبل» ويمكن أيضا تحديد موضوع الرسالة البريدية 
subject‏ من خلال اضافة الموضوع بlلمتlح .EXTRA_SUBJECT‏ 


٠ه‏ ۴14: وهو متغير يحدد كيفية إنشاء الفعالية وما المهمة التي ستتبع لها وكيف سيتم التعامل معها بعد الإنشاء. 
في الغالب لن تحتاج إلى تحديد قيم لهذا المتغير. 


تشغيل الفعالية (40151]7) باستخدام الهدف (٤مءtہ1)‏ 


يمكن تشغيل فعالية عن طريق فعالية أخرى ما عن طريق تنفيذ الدالة 0را ز۷] 4۲۲4ء وتمرير هدف صريح 
ten)‏ icitاxp£)‏ يحدد الفعالية المراد تشغيلها. الهدف (10]676) قد يحوي بالاضافة إلى الفعالية المراد تشغيلها 
بيانات أخرى مراد تمريرها للفعالية الجديدة. 


الكود التالي يوضح تشغيل الفعالية 51521/41119716 باستخدام هدف صريح (10]626 11016م8:2) وتمرير بيانات 
لها عن طريق حافظة الإضافات (2:235) الموجودة ضمن الهدف (106606): 


EN 5226 EEE‏ تت ل ادامر م ع 62 ) Mew IMECME‏ 6 كلت 6 كلد 2 كرت 6 طلا 
CLASS)‏ برعا لدي SOM RACE‏ 

im EERE. لاك‎ EEA S (SUSE ER 2ت‎ 7, Amed), 

5 لك كعات ضع ماك عا‎ VE CRE) 


لاحظ أن إضافة البيانات يتم في الحافظة 8:35 بطريقة المفتاح والقيمة (72106-/12©3)» حيث يستخدم المفتاح 
(1>67) لاحقا لاسترجاع البيانات من الهدف (مع)م]). الفعالية التي تم تشغيلها باستطاعتها قراءة الهدف (6)م0ع106) 
عن طريق تنفيذ الدالة (6121611)0عع ومن ثم استخراج البيانات المرسلة من خلال الهدف لمعالجتها. 


في حالات أخرى قد تحتاج إلى تنفيذ إجراء معين (4110) مثل إرسال بريد إلكتروني أو رسالة نصية. في هذه 
الحالة قد لا يملك البرنامج أي فعالية محددة لتنفيذ الإجراء المطلوب» ويمكن استخدام فعاليات توفرها تطبيقات 
أخرى موجودة على الجهاز. يمكن تنفيذ ذلك باستخدام هدف مضمن (1016726 11016م102) يحدد نوع الإجراء المراد 
تنفيذه حيث سيقوم النظام تلقائياً باختيار الفعالية المناسبة للإجراء المطلوب من أي تطبيق آخر على الجهاز. في حالة 
بطلب تدخل المستخدم لاختيار الفعالية التي يريدها لتنفيذ الإجراء المطلوب. على سبيل المثال» اذا أردت السماح 
لمستخدم بإرسال بريد إلكتروني من خلال تطبيق معين» يمكن تنفيذ ذلك بالكود التالي: 

mie eM E AM Elem Mme 1122226 (MEER, لكك لشت‎ SEND) 


mE ERIE MEE CE EE (OE ERE ESER A EMA TEY EE e OOM EATON) 
5 ماك عا‎ EA ع سك ) الك مات‎ ERE 
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لاحظ أنه تم إنشاء الهدف (]10]60) باستخدام الإجراء المطلوب ((4077107_5182]1) ولم يتم تحديد فعالية 
محددة لتشغيلها. الثابت ,251184113411 المضاف للهدف (10]676) يحدد المصفوفة recipientA1ray‏ 
والتي تحوي العناوين البريدية المراد إرسال البريد إليها. هذه العناوين البريدية يتم إدارجها في خانة "إلى" (0]) 
ضمن نموذج إرسال البريد. 

ملاحظة هامة: عند إنشاء الفئة (1358ح) الخاصة بالفعالية الجديدة تأكد أن الفعالية تم تعريفها في ملف الوثيقة 
(14650م813) وذلك بإضافة الخاصية 20107167 داخل الخاصية 201102610 في ملف الوثيقة )7121165 كما هو 
موضح: 


APPLE EON 


CAG EL VILL 
android:name="ps.edu.ucas.example.NewActivity" 
am El OLE 1515:1763 6 11ت _ ملع انع ودع‎ COCALLSY 2 
> / 17ع 621711 هق‎ 


</application> 
حيث أن قيمة الخاصية 2176 :20207010 تشير إلى مسار الفئة (241م01355) الخاص بالفعالية الجديدة.‎ 


في هذا التمرين سنقوم بالتعديل على تمرين (3-3) والذي يقوم بعرض قائمة (سع۷1ء11) بأسماء المدن 
الفلسطينية. التعديل المطلوب إجراؤه هو تشغيل فعالية جديدة (رز1)ء۸) عند النقر على اسم أي مدينة وذلك 
تمرك مطرمات عن هذه المدينة في الفعالية الحديدة كما تاكن 


Jerusalem 63723 


Ramallah 


Area: 360 km2 
Population: 1,816,379 


Jenin 
Largest City: Gaza 


Nablus 
کڪ‎ WORTH GAZA ست‎ 
32 کک‎ 


مجو 
Tulkarm ECT o‏ 


Al-khalil ` RM 


Haifa ا‎ 


کح مين 


MAP OF THE GAZA STRIP 


RAFAN 


Yafa 


أ 


Areeha 
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بالأسفل ملف الواجهة الخاص بالفعالية الجديدة» والذي يتكون من عناصر 2]57160ه1 و 112386171616 لعرض 
التفاصيل النصية والصور الخاصة بالمدينة التي يتم اختيارها من القائمة (15]87169.آ). 


<LinearLayout 
xXMINS:andrOoO1d-IMEEP://ScChemas . aANdEOLGA. COM/apk/FeES/andFO1 QAL 
اناعد‎ 15 ECO OLS 665 2 / / 5 ات‎ 2101-2-57: ARO ESRA COM EO OLS 
عنام اماع‎ O LOI 1O WOT Ol LE E ie 1 Û Ê Û 4 
مك لت‎ OG aA OU E GE MS MAEM Oa Eenm E 
AMEE OMG ال‎ 8576135 ME O MES Emele DM م‎ 
android:orientation="vertical"™ 
android:paddingBottom="@dimen/activity_ vertical margin" 
android:paddingLeft="@dimen/activity_ horizontal margin" 


android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
15 © 6211-5 COM ECE COM exam LEE SAME KE LMS E DOE MSA E EE 
<TextView 
android:id="@+id/tvArea" 
AGE ORE SAO E EGE MS AS COM EER E 
:11ت مك لت‎ A OE 52ت 1ت‎ ESS COM ECEME 
ARE EON ك‎ 2 EE 6 5 1 Ze > 2 USO 
1م اده تممه‎ LA YOU E_ MEGIR 16 كه‎ 20E 
ARIFO EEE > Reze VA eM > 
<TextView 
سات 1ت‎ 61617 LOA ET LOY ا ع‎ EARS 
ع ك1 210115 لا 11ت مك لت‎ EAS لاست لت‎ 
14ت تدك لت‎ 11210716 Me O MES ESS COM ECEME 
211 عرلت‎ SMO 4 6 عدت‎ 625226-25 
0ت 217015 1 2 110 0 تك لله‎ 16-2 0 
312012010 : text="TextView" /> 
<TextView 
ARE ASS ES CT O EEA SES ECA E 
AEE eG ES OU E EE لكر سن‎ COM EE E 
AMES GE ال‎ 5761315 ME EOS DES ASO COE CE 
مراك لات‎ SMO : 2 عدت‎ 6 512-205 
6ت 257050165 لل :114 0 تدك له‎ 0 1152-0 
android:text="TextView" /> 
<ImageView 
android:id="@+id/ivMap" 
وساممة‎ 11615 LE MOE _ 111-52775235 CORE ER E 


5 
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eG EES OME ME OG MES IES EO ECEME‏ تنك لت 

AMOEOLE S LAVOE _ 612 مرق م 153-11 57ت‎ EOE 

OME EEE SZ 2 USE‏ مزلت جلت 

android:layout_marginTop="20dp"/> 
</LinearLayout> 


الكود بالأسفل يوضح الفعالية الجديدة (رزلنا4Aء1ذه†ه0)‏ والتي يتم فيها عرض تفاصيل المدينة التي يتم اختيارها 
من القائمة (wع۷1†ء1ا).‏ 


| 6ك ات 2 5 لكت عدت 617 لدي دراك ك 5 1ل CESS Delal‏ 1164 وناك 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
SEE GC OMIE ست‎ EVE I OE TAO E AEE Ey dea اك‎ 
TextView tvArea = (TextView) 
ERAS. EANCVAISWOVIQA (RK. 161+ 68231 م‎ 
TextView tvPopulation = (TextView) 
هلعا‎ 115 EE REVEBE GORR E EEO aE OR) 
TextView tvLargestCity = (TextView) 
E SE ROSIE NGS (ER ع 813166268 د امب‎ VD 
ImageView ivMap = (ImageView) 
E SEE اك للد‎ EWE اك لير‎ RTO MAD) 
EEE Am ك2‎ 5 >. EMS OEE MECN E 
String cityName = 
عات 6 1ل‎ E SEES EEAS (EOE ES E E LO ع‎ 7 ( 
ES SEEN E E (EEN EME 
11 (cityName.equals ("Gaza") ) 1 
tvArea.setText ("Area: 360 km2"); 
EOD 11 2 ENCORE SE ELEC E LEO 11س‎ 2 EOE 17 5116 SOD E 
5 ات ل‎ 065 26211 617: SE Ee ) 212055-15 CEY Caza), 
ivMap.setImageResource (R.drawable.gaza) م‎ 


SOE 62 AS OE OSS ا‎ 


065 ا 5 ا‎ 2 6 O 0د 0 0 تت ك1‎ d0 00 06 0 0 oo 


O RS O o E E E E لكك كم‎ EAE E Î 
ORS E 895 


N N 
حر ان‎ 


38 
ال 
محتوى واجهة الفعالية (/106]2115/401571697) يتغير بتغير اسم المدينة الذي يتم إرسالة من الفعالية الاولى من خلال 
ت اماف الجزء الأساسي في الكرد هر قراءة اليف (0684) المرسل من فعالية الندية باستخداء الذالة 
() ntentآtهع‏ (أنظر سطر رقم 15). قراءة البيانات المرسلة في الهدف (10]626) يتم بقراءة الحافظة الموجودة 
ضمن الهدف باستخدام الدالة getExtras)‏ ومن ثم تنفيذ أحد دوال القراءة حسب نوع البيانات المرسلة مثل 
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(1840]عع و n0‏ tStriهع‏ (أنظر سطر رقم 17). بناءً على اسم المدينة الذي تم ارساله من فعالية البداية يتم تعبئة 
محتوى الفعالية .(DetailsActivity)‏ 


ملاحظة: تأكد من إضافة تعريف الفعالية (/126]115.411916) في ملف الوثيقة ()وع1نمة3/1). 


بعد إنشاء الفعالية المراد تشغيلهاء نقوم بالتعديل على فعالية البداية (MainActivity)‏ والتي تحتوي على القائمة 
(115]97167) وذلك بإضافة الكود التالي داخل الدالة ()ك7):[11»1مع:1من0 الخاصة بالمستمع 


:OnltemClickListener 
[15 15ل‎ Ee SEE OM EE GC ETE عا د‎ CREE (REM 
2 عات 1 11ت | كه‎ SERE )( ' 
5 
4: @Override 
5: public void 021162011 عله‎ (AdapterView<?2> parent, View 
6 view, IME 56552 62127 OMS AO) ! 
18 String cityName = 
5: عكرت كدت كل‎ OSE NECM هن 8ع‎ 51 ELON (POSE HOR) CEOS AMO )( 
58 MECN E AM 5ل ع2‎ > Mew لل م كرك ع 62 ) عجرت عا لجرلا‎ 1122 E HOME ORE EE )( | 
103 15 5 A 215652151 657 CASS م‎ 
لظلا‎ RESME شك لك‎ SERS E E, CM 6 ت‎ e) 
1285 8 الدع شنم تمع‎ EW (AR شاكع‎ E) ع‎ 
OE } 
148 م11‎ 


لاحظ أنه تم إنشاء هدف صريح (101600 11014م:8) يحتوى فئة (ووه1ء) الفعالية المراد تشغيلها وهي 
Deta Activity‏ (أنظر السطرين رقم 9 و10). تم بعد ذلك حفظ اسم المدينة الذي تم النقر عليه في الحافظة 
(Extras)‏ باستخدام المفتاح راذع (أنظر سطر رقم 11). وفي النهاية تم تشغيل الفعالية باستخدام الدالة 
Activity0‏ )ا (أنظر سطر رقم 12). 


إنشاء فعالية من أجل نتيجة (Starting an activity for a resul)‏ 
في بعض الأحيان قد تحتاج إلى استرجاع نتيجة من الفعالية (راز1اءA)‏ التي قمت بتشغيلها: فمثلاً قد تنشئ فعالية 
لتطلب من المستخدم الاختيار من قائمة ما و ترجع النتيجة إلى الفعالية الأساسية. في هذه الحالة يمكن استخدام الأمر 

start Activity ForResultÛ‏ بدلاً من 1۷00ا Ac‏ ta/1ء.‏ لاستقبال النتيجة من الفعالية الجديدة. 

لتوضيح آلية التواصل بين الفعاليات 8171665 في هذه الحالة» افترض أن هناك فعاليتين ۸ و 8 بحاجة 

للتواصل بحيث تقوم ر بتشغيل 8 وانتظار نتائج منها. شكل 4-3 يوضح آلية التواصل بين الفعاليتين: تقوم الفعالية 
۸ بتشغيل الفعالية 2 باستخدام الدالة Acti vity۴ ۲R esu10‏ اtarء.‏ الفعالية 8 بدورها تنفذ إجراء معين 
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0 hiاDoSome‏ ثم تقوم بتجهيز النتائج على شكل هدف (1016726) وترجعها بتنفيذ الدالة (56]166510160. عند 
إغلاق الفعالية 8» بالنقر على زر عآاع83 مثلاء تعمل الفعالية ۸ ويتم تلقائياً تنفيذ الدالة )(ئonActivityResu1‏ 
والتي يمكن من خلالها قراءة البيانات المرجعة من الفعالية 8. 


B_activity 


DoSomeThing() 
SetResult() 


Finish) 


A_activity 


startActivityForRe sult 


onActivityResult() 


شكل 4-3: التواصل بين الفعاليات (19101©5) 4 ) في حالة تنفيذ الدالة startActivityForResu1)‏ 
لتوضيح هذه الخطوات عملياً سنقوم ببناء تطبيق بسيط يوضح هذه الآلية. 
في هذا التمرين سنطبق مفهوم تشغيل فعالية (4511697) من أجل إرجاع نتيجة. واجهات التطبيق موضحة في 
الشكل»ء وهو مكون من فعاليتين (421716165): الفعالية الرئيسية تظهر زر عند النقر عليه يتم تشغيل فعالية جديدة 
تظهر قائمة من أسماء أصدقاء حيث يجب اختيار قائمة الأصدقاء المفضلة منها. بعد إنهاء الفعالية الثانية بالنقر على 
زر )عه ۰8 يتم تشغيل الفعالية الرئيسية ويتم طباعة قائمة الأصدقاء التي تم اختيارها على الشاشة. 


كت الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


Choose Your Best Friends 


Ahmed 


Fadi 


Û‏ لا ك8 


lyad 


a3 


Ibrahem 


Rami 


Osama 


Û‏ لا ك8 


Omar 
Choose Your Best Friends 


لا 


Amjad 


Selected Friends 
Ell 


لطا 
Omar‏ 


شكل 4-4: واجهات التطبيق الخاص بتمرين 4-2 والتواصل بينها. 
الكود التالي يوضح الفعالية الرئيسية :)(MainActivity)‏ 
EN EY CECI S AOE EV‏ مانم CLASS MSA‏ 510150118 


SES ENE MIE REOUE SR CODE E SO 1 Am ED MUMEEE‏ 28 لمكم 
@GOverride‏ 
protected void onCreate (Bundle savedInstanceState) {‏ 


ODS E‏ كن إن 
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رقم المقرر 
م super.onCreate (savedInstanceState)‏ 6 
SEE CG SMI CR EVE (E TEMO E AEE Ey MA‏ 18 
EMEEONn CEN > (EUEEONM)‏ :85 
OE ESE IMO ECOWE TGR RS OE EO)‏ 
OE btn.setOnClickListener (new OnClickListener )( {‏ 
1L8‏ 
@GOverride‏ 28 
BMC ILE ZONES ORC e Te 0‏ ا 
Intent intent = new‏ :14 
OF‏ كدت ع لت 4 كت 1د 22 11 لل فرك 2ع 65 ) SE RECOM E‏ 
CLASS)‏ : 7 عا لدب 1ك 562 31511 11ت 11 18 ف ,©1 
SEA ELE ET E ORE SE EEN IE 112101015915 CODE‏ 11785 
} 12 
)م 192 
J}‏ 203 
21 
@Override‏ :22 
VR EVRESEOL EERE Eee SECO E MIE‏ اك شه VOLE‏ 00-5556 رم 29 
resultCode, Intent data) {‏ :24 
52560 11 5ت 2 26019-55666402 ط ) ع 11ت 1ن عا UA‏ ع كت شارك SUPE ١‏ :25 
CALA)‏ 2603 
if ) 2260125 ECOdeE >> REOUESL CODE 26 2201-6006 >>‏ 20 
RES UEE CODE) f‏ بوك1 EAE E‏ 11 5106018 1211 13 8 
ArrayList<String> selectedFriends =‏ :20 
GEE 12205‏ 2 2 26 1ل EEA (Se‏ شع 5 لط راك عل عل اك 119 لك عل عا 5 025 377 6215 :9320 
E ML‏ 26ت دضه 65ت لت ! > MSO‏ م تسرئاة 5 
كك نت 11 1 تامت عاك تك لكك E OE (SEE ANO EEE‏ 8 32 
A Ig f‏ كا TSG) FE E‏ 3 
LCA E ORE OR E CECE )( MSO,‏ م مضع 5 60 ) 2 عت 11 103/2 TOA SIE ٠‏ :34 
SSS MOS E EEG 26106 ESO‏ 
} 36 
SI: }‏ 
IES J‏ 


لاحظ أنه عن النقر على الزر “Choose Your Best Friends”‏ يتم إنشاء هدف صريح (Explicit Intent)‏ 
بالفعالية المراد تشغيلها وهي (05[1.15]411571م1ء2) (أنظر الكود من سطر 14 إلى 16) » ثم يتم تشغيل 
الفعالية عن طريقة الدالة ()]1ناوء4000716910119:ج5 والتي يمرر لها الهدف (10606) باللإضافة إلى قيمة 
رقمية تستخدم كمعرف للطلب 6وع11اوج:» حيث يمكن استخدام أي قيمة رقمية من نوع 1ععع]10 (أنظر سطر رقم 
17 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


بعد الانتهاء من العمل في الفعالية الجديدة» يتم استقبال النتيجة في الدالة ()]1ناوع0082119716(/16 (أنظر سطر رقم 
3) والتي تنفذ تلقائياً عند تلقي النتيجة. من خلال الدالة (1160او©400171912.م0 يتم تلقي ثلاث نتائج هي: 
request_codeء‏ t_codeاresu‏ و 038. القيمة 006ح_ؤوع نالع تحدد معرف الطلب الأساسي ويفترض أن 
يطابق نفس القيمة التي تم إرسالها عن تشغيل الفعالية (فحص هذه القيمة يفيد في تحديد الطلب الذي تم الرد عليه في 
حالة تنفيذ أكثر من طلب لارجاع نتيجة). القيمة الثانية result_code‏ يتم إرسالها من الفعالية الثانية وتفيد كمعرف 
لمصدر النتيجة. القيمة الثالثة وهل هي هدف (امءم]) يحتوي بداخله على النتائج المرجعة. لاحظ أن النتيجة 
المرجعة عبارة عن قائمة مة ArrayLisy<String>‏ تمثل الأسماء التي تم إختيارهاء وقد تم استرجاعها من الهدف 
(مع)م1) عن طريق تنفيذ الدالة (15]13:020آ1391ع510]مع (أنظر سطر رقم 29 و30). بعد ذلك يتم 
تحويل النتائج إلى رسالة ار على الشاشة. 


الكود التالي يوضح الفعالية الثانية FriendsListActivity‏ وتكون من نوع :ListActivity‏ 


:public class FriendsListActivity extends ListActivity 1 
BOME اكت تك‎ MME RESULE CODE E CO Ey ED BUME E 


@GOverride 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
ArrayList<String> friendNames = new 

ATE aN SES EE MO )( 
friendNames.add ("Ahmed") ; 
friendNames.add ("Fadi"); 
friendNames.add ("Iyad"); 

friendNames.add ("Ibrahem"); 

( 

( 

( 


IS OUOE ODN E‏ 9 ©0]) د 


friendNames.add ("Rami"); 
friendNames.add ("Osama") ; 
friendNames.add ("Omar") م‎ 
friendNames.add ("Amjad"); 
ArrayAdapter<String> adapter= new 

ArrayAdapter<String> (this,android.R. 

208 AOU EE Sm LE _ 2516ل‎ Ee RU EES LE E ROE 121 21253391 م‎ 

2 this.setListAdapter (adapter) ; 

22: getListView )( .setChoiceMode (ListView. 

255 62109 1612 MODE MUR TE RE) 7 

24: GgetListView )( .setOnItemClickListener (new 

Om em EN e SE EME )(‏ دكت 


d 
d 
ك6‎ 
6 
5 
0 


OO J GO UO Bb WN N وو هه .هه © لإ‎ oe oe oo oo oo 


Ke 


27: __CGCOverr1de 
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public void onltemClick (AdapterView<?> parent, View‏ :25 
ev, EME ECOSUN OM, OMS MO |‏ تواتك 
0E SEVE LSE — Ge EM SEVE W (J‏ 
SparseBooleanArray checked‏ ا 


2S SEVE. GE EERECEKEE SG N كك للكت ع‎ E OMS OE 
SSS مت 6 6ت لت 5 1190-7 عدن 5 6 211125 ترصك‎ EEMS < MEW 
SAS عل عا > عاك سر 3 تعره‎ DO )( 
كاك‎ EOE mE د‎ O ا اكه 7 () 216 26ت 5 بات درتت د ئلا > د‎ 


356 :متاك تاك ) له‎ OEE (OD 

3: selectedItems.add(listView.getItemAtPosition (i). 
IE EOE IMG 0Y J 7 

3I J 

420: 12 6 كدت‎ imeenE Mev IMEC )( 

41 intent.putStringArrayListExtra ("selectedFriends", 
42 selectedltems) مم‎ 

45:  SEERESULE (RESULE CODE, نت‎ 

A42 / 

)م :45 

46: ( 

47:} 


لاحظ أنه تم تعبئة قائمة العرض (wع1۷1ء11)‏ بمصفوفة الأسماء باستخدام 1ع]م41123:82 كما هو موضح في 
الكود (أنظر الكود من سطر 8 إلى 20). لاحظ أيضاً أن القائمة (1569/1610]) تسمح بالاختيار المتعدد من خلال 
تنفيذ الدالة set Ch0iceMode)ListView.CHOICE_MODE_MULT1IPLE)‏ (أنظر سطر رقم 22). 
لاحظ أيضاً الإجراء الذي يتم تنفيذه عند اختيار عناصر من القائمة (1.15]5971617]) حيث يتم حفظ العناصر التي تم 
اختيارها في قائمة <4133115]>501128 (أنظر الكود من سطر 28 إلى 39). لارجاع هذه القائمة للفعالية 
الرئيسية» يتم إنشاء هدف (10626) وحفظ القائمة به عن طريقة تنفيذ الدالة putStringArrayListE—Extra()‏ 
(أنظر سطر رقم 41). وأخيراًء يتم إرجاع النتيجة عن طريقة تنفيذ الدالة ()56)1+65014 حيث ترسل النتائج 
بالإضافة إلى رقم 006ه_116اوع1 ليستخدم كمعرف لمصدر النتائج (أنظر سطر رقم 43). 


(Intent Filer) مرشح الهدف‎ 


مرشح الهدف (1116617 106626) هي خصائص يتم كتابتها في ملف الوثيقة (ع۴1 31311465]6) التابع لتطبيق ما 
وذلك بهدف تحديد نوع الأهداف (10]605) التي يمكن للمكون (الفعالية »الخدمة أو المنشور) استقبالها. على سبيل 
المثال» بالإعلان عن مرشح هدف (/181661 06ع]10) لفعالية معينة داخل ملف الوثيقة» فإن التطبيقات الأخرى 
المحملة على الجهاز قد تتمكن من تشغيل هذه الفعالية إذا تم إرسال هدف (Intent)‏ يوافق مرشح الهدف Intent)‏ 
1) اإذا لم يتم تحديد مرشح هدف للفعالية فلا يمكن تشغيل هذه الفعالية إلا باستخدام هدف صريح (11106م:1 
.(Intent‏ 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


يمكن أن تعد تطبيقك لاستقبال أنواع محددة من الأهداف (1062]5) عن طريق الإعلان عن مرشحات الأهداف 
5 (إع]10) في ملف الوثيقة (ع۴11 stعManif(‏ باستخدام الخاصية .<intent-fil{er>‏ 


كل مرشح هدف (۲ع)۴11 )مع]10) يحدد نوع الهدف (0]6ع]10) الذي يمكن لمكون التطبيق استقباله بناءً على نوع 
الإجراء المحدد في المرشح ونوع البيانات 01368 والتصنيف رإمعع)هء. يقوم النظام بإيصال الهدف (10]606) إلى 
مكون تطبيقك فقط إذا توافقت محتويات الهدف مع تفاصيل مرشح الهدف (۲ع)]۴ 10]626). على سبيل المثال» 
يوضح الكود بالأسفل جزء من ملف الوثيقة (1و8114) والذي يبين مرشح الهدف لفعالية باسم :Share Activity‏ 


<activity android:name="ShareActivity"> 
>10 2 21 EEE 
<action android:name="android.intent.action. 58111" /< 
EE LOI 
android:name="android.intent.action. SEND MULTIPLE" / < 
SEA ECS SREY 
android:name="android.intent.category. DEFAULT"/> 
<data android:mimeType="text/plain"/> 
</intent-filter> 
>/ هت‎ 6171857 


ه الإجراء الذي تنفذه الفعالية (م]عه)ء وهو في هذا المثال من نوع ACTION_SEND‏ أو 
.ACTION_SEND_MULTIPLE‏ 


ه التصنيف رإهعم)اهء وهو في هذا المثال من نوع 16421016» وهو التصنيف التلقائي لأي فعالية غير فعالية 
ابتداء البرنامج والتي تأخذ تصنيف LAUNCHER‏ . 


ه نوع البيانات التي تتلقاها الفعالية من خلال الخاصية 0262 (مثال: منه[م/اء<ء)). 


ذكرنا مسبقاً أنه عند تشغيل فعالية باستهدف هدف مضمن (10100 11016م10)» يقوم النظام تلقائياً بالبحث عن 
الفعالية المناسبة لتشغيل الإجراء («ه1)ءA)‏ المحدد في الهدف المضمن (102]6726 11016م120) ضمن كل التطبيقات 
المحملة على النظام. إذا توافق محتوى الهدف المرسل (101626) مع تفاصيل مرشح الهدف (Intent Filter)‏ 

الخاص بأي فعالية» يقوم النظام تلقائياً بتشغيلهاء أو عرض خيارات في حالة وجود أكثر من فعالية يمكنها استقبال 
الب 


ملاحظة: يمكن تحديد أكثر من إجراء داخل مرشح الهدف» مما يعني أن الفعالية يمكن أن تعمل اذا توافق إي إجراء 


معرف في المرشح (111]67 10]626) مع الإجراء المحدد في الهدف المرسل (6م12]6). 


يوضح الكود التالي كيفية تشغيل فعالية إرسال رسالة باستخدام هدف مضمن .(Implicit Intent)‏ عند إنشاء كائن 
من نوع (]160)؛ تم تمرير الإجراء المطلوب وهو إجراء العرض (8710171_51:315)» ومن ثم تم تضمين 
البيانات المطلوب عرضها ,وهي الرسالة المطلوب إرسالها, من خلال الدالة ()11]15:2]3م. يقوم النظام تلقائياً بتحديد 
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الفعالية المناسبة للتشغيل عن طريق مطابقة نوع الإجراء ونوع البيانات المرسلة مع مرشح الهدف ( 06ع]10 
111 للفعاليات الأخرى . في هذه الحالة سيقوم النظام باختيار فعالية يمكنها عرض إرسال الرسائل. 


mew IMEEM )(‏ عشت 2607 5ه عالت علسلا 

TON SEND) «‏ مك E.‏ ارت 6 ) OR‏ نمت ك8 نا تك IMEEM E:‏ ك 27ت 5 

5 رم :6 1ت 16م 611 11ت‎ EEE EA (IR ع‎ CRE : ل تاك لكا‎ 2 611 5 
SERCO ESM E . 861515758 (ATE PLAIN TET XES) 7 

5 6 مرك‎ E عات اش‎ N E VI (SE RE LR E CRE) 


في حالة وجود أكثر من فعالية يمكنها تنفيذ نفس الإجراءء يقوم النظام بعرض خيارات للمستخدم ليختار منها 
الفعالية التي يريدهاء كما هو موضح في الشكل: 


Bluetooth 


العيرة) 


Google Voice 


6001+ 


١485530150 


Twitter 


شكل 4-5: خيارات تشغيل متعددة للإجراء (0110171_515171 A‏ 1 
تمرين عملي (4-3) 


في هذا التمرين سيتم تشغيل عدة من الفعاليات (Activities)‏ لتنفيذ بعض الإجراءات (6005عم) شائعة الاستخدام 
مثل تشغيل متصفح الانترنت» الاتصال الهاتفي و عرض جهات الاتصال 02]2015ح0. كل ذلك يتم باستخدام هدف 
مضمن (10]606 ]1[مدم1) يحدد فيه الإجراء (100]ع4) المراد تنفيذه. سنجرب أيضاً إمكانية تعريف مرشح 
هدف (111]6 tہمtہ])‏ لفعالية (رtزہنا٥۸)‏ ضمن تطبيق تم إنشاؤه مسبقاً. 


شكل 4-6 يوضح واجهة التطبيق وهي مكونة من مجموعة من الأزرارء حيث أن كل زر مسئول عن تنفيذ إجراء 


معيل. 


Intents and Intent Filters, Android Developer, http://developer.android.com/guide/components/intents- 
filters.html 
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Open UCAS Website 


Call Friend 


Open Contacts 
Open User Activity 


Launch App 


شكل 4-6: واجهة التطبيق الخاص بتمرين 4-3. 
تصميم الواجهة الخاصة بهذا التصميم موضح بالأسفل: 
<RelativeLayout‏ 
xmlns:android="http://schemas.android.com/apk/res/android"™‏ 
COM AE OS SL‏ 1-1 كت 7 210257 للكت 5 / / 5 EES‏ 06 !5 11ت 4ع د SIMS‏ 
كت 216 م اجات 6ت ا > AMEE E HE OE GE‏ 
OMG SAMO MEE MES Ema EE BM OAEEME‏ ممه 


android:paddingBottom="@Gdimen/activity_vertical margin" 
android:paddingLlLeft="@dimen/activity_ horizontal margin" 


android:paddingRight="@dimen/activity_horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
EOS LS: CORE ENES Mama EEE > 
SB EEO 

android:id="@+id/openWebpageButton" 

AEE 621615 AO E EGE MS AS COM EEN E 

E EG ES ESS COM ECEME‏ 112176 11ت مك الت 

AEE OG E EA OE a ESE AEM م8 ع‎ EE UE 

E EE‏ 11ت 2ت 12 شاك E MOE COME CE‏ 1ت 6116 10ت 

د مت MATOS‏ 200165 11 :01741 تلك لله 

android: text="Open UCAS Website" 
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android:onClick="openUCAS" /> 

SBE EON 
android: id="@+id/callButLton 
:14ت 1ك 17ت‎ la VOU E GEM WES OOM ECM 
ARE EOE SAMO _ 1861© 105 ES COM ECEME 
android:layout_ below="@+tid/openWebpageButton" 
AIEEE EG E ES OME COME CE تع ات 212 عت‎ LS rE 
android:text="Call Friend" 
Em كه 1ه مزلت‎ E OCI 1e =WEAL I Re 1EME 

/< 

15/1015 5 610 
ARO TORS 11 كت‎ EC SA COM 6 6ت‎ SEE EOL 
a Ee EG EES OU E IEE MS ESS COM EE E 
تنك لت‎ EG EEA OME 52ت 1ت‎ ESS COM ECEME 
android:layout_ below="@+tid/callButton" 
14ت تلك للك‎ 2 la YOU E COMI ECE O 12 ات‎ A L> EEE ll 
كدت قدلك كات‎ E EeSSE > LOBEM COME SCE S 
SRE EOE 47ت 11 1ت ات‎ OEE E EEE S 

/< 

1116 ع‎ 
android:id="@+id/openActivityButton" 
11ت‎ 01 02114: la vyOUE Mid IES OOM EERE 
مله‎ 115576135 REGS MES ESE COM EERE 
android: layout_below="@+id/contactsButton™ 
تلك 17ت‎ OG EES OU E COME CE تعن 12 مات‎ SEE 
SEATE ك للدت‎ 2 EE EOE USE AOE YL 
217 6112 © 101: ORCI EK OPERA GENE > 

SBME EON 
android:id="@+id/lauchAppButton" 
AREA EOE SA VOU E EGE MS EA COM EEN E 
ARE EOE SAMO E 158616 1055752379 CON EEE 
android: layout _ below="@+id/openActivityButton" 
AME EOE E KE OE CEE CE O ASME لات‎ 2 EE 
android: text="Launch App" 
ادر 16د‎ E ORC IME k> الور ا‎ 1> 

</RelativeLayout> 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


أحد الإجراءات التي يشتمل عليها التطبيق يتضمن فتح قائمة جهات الاتصال (Contancts)‏ من خلال النقر على 
»"0pen Contacts"‏ وهو ما يتطلب إذن 5و1وؤ1رمععم. لذلك» يتم إضافة الإذن التالي إلى ملف الوثيقة 
:Manifest‏ 


<manifest ...> 
<uses-permission 
android:name="android.permission.CALL_ PHONE" /> 


< manifeclz 


أحد الإجراءات التي يتم تنفيذها (عند النقر على الزر (“Open User Activity”‏ هو تشغيل فعالية (Activity)‏ 
موجودة ضمن تمرين 4-2 في الوحدة الثالثة (أنظر الشكل 4-4). حتى نتمكن من تشغيل فعالية ضمن تطبيق آخر 
(الفعالية /و111205115]46510)» يجب أن يتم ذلك باستخدام هدف مضمن (10]626 11016م122) (لا يمكن 
استخدام هدف صريح 104606 1116م:) وذلك لأن الفئة (01355) الخاصة بالفعالية الهدف ليست في نطاق التطبيق 
الحالي). لإنشاء هدف مضمن (1026676 11016م102)» لابد من تعريف إجراء (4102) للفعالية المراد تشغيلها. 
لعمل ذلك» يجب إضافة (17ع111 غمع]10) للفعالية المراد تشغيلها ضمن ملف الوثيقة (341314656) الخاص 
بالتمرين 4-2 كما هو موضح: 


yy android:name=".FriendsListActivity" 
مام داق‎ 61615 11 ae N ESET 51 EE aC E E CRASS 
<intent-filter> 
<action 
android:name="ps.edu.ucas.example.FriendsListActivity" /> 
<category android:name="android.intent.category. DEFAULT" 
> 
AREER ESEN EEE 
JACEE ALVA EVE 


لاحظ أن اسم الإجراء المستخدم ضمن الخاصية :3011010 هو مسار الفعالية .(Activity)‏ يمكن استخدام 
أي اسم بديل بشرط عدم تطابقه مع اسماء الإجراءات المستخدمة في فعاليات أخرى. 


الكود التالي يوضح الفعالية (MainActivity)‏ والتي من خلالها يتم تنفيذ كل الإجراءات المطلوبة. 
|[ 7 تك 65ت 62 كدت عاك دكات شوك BUCE Class Ma‏ 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 


ا اوا كير 
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super.onCreate (savedInstanceState) ; 
SEE 6 SMI CR EVE E TEYO E AEE Ey Ma 


} 


public void openUCASs (View view) { 
mE عات‎ En EEE SS Me MECN E (ERIE OIE ACEO ATED 
رت 6 7ه‎ 6 - SEED AE aA (UBL PASE ) : 6 8ع‎ SK. MEAS EAM BSL) 
ERS SEATE CEERI 2 عات‎ 
/ 


| نات كت (Vi eW‏ أك كت 1 VONO CALLER‏ ك1 ل ولاس 
ست AGRON‏ عالت in Een E > mew MECN E (ERE‏ الات mE‏ 
١ Se EDa 62 (UE PaESe (EEL 2: 16"‏ ع جلت 6 im‏ 
E (A EEE)‏ 1ك عات ضع ملأت عت ESE‏ 

/ 


public void openContacts (View view) { 
للك‎ emi En EEE SS Ee MEE E (ERE OIE AGE KO ATED 
intent .setData (UrFİi.parse ("content ://contacts 
/oeooLe/™) ) § 

ENS SEATE LOE AVA E ) 1 2 ك2‎ 


} 


BUNGE ZOMG جات مه‎ N E EW e) | 
Intent intent = new 

SL S EAC EN E),‏ لك حت 1 كرك UCAS E xSAMPLE.‏ 41ت LPS.‏ ) عجرت 6 سسا 
ELC EVA E (ER ECE‏ مراك عارك ESE‏ 

} 

public void lauchApp (View view) 
IMEC E AMEeME > Meu IMEC E 
intent.setComponent (new 

ComponentName ("ps.edu.ucas.example"™", "ps.edu.ucas. 

CSA MO LE MARAE EV EE ل‎ 
mi لت‎ E Se E EAC S MEE RE EAE E TTY NEV EASE 
ESS ملت ع‎ GET E (AREER E) 


ا 
(Intent. ACTION MAIN) ;‏ 


في ما يلي يتم توضيح طريقة تنفيذ كل إجراء: 


ECE 606 IS O 


65 A O OM E CS RS كأ‎ @ CO 50 0 0 0 


+ لم لم كم هم كم كخم هخم هم كم N N N‏ 
RS!‏ ات لحن ام 


N 
دن‎ 


N NN N N‏ ذخا (ى) WNW‏ (لم) (لم) (لن) (تي) (ي) (ب) لب) (لي) 
حل انه ES 1 O.‏ كا تك O E‏ ل حكن رن eM‏ لد US GS‏ 


کک 
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الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


الدالة ()217045ءم0 (أنظر الكود من سطر 9 إلى 13) يتم تشغيل متصفح إنترنت 1ء68015 طء/71 لفتح 
موقع الانترنت الخاص بالكلية الجامعية. يتم إنشاء هدف (626م1) و تحديد الإجراء )(A۸ACTI0٥0N_ VIEW)‏ 
وتمرير عنوان موقع الكلية عن طريق الدالة ()56]1(268. في حالة وجود أكثر من متصفح تظهر قائمة لتمكين 
المستخدم من اختيار المتصفح المطلوب. 


الدالة (51111600» (أنظر الكود من سطر 15 إلى 19) يتم فيها إجراء اتصال هاتفي برقم محدد. يتم إنشاء 
هدف (26ع10) وتحديد الإجراء (.420011011_04111) وتمرير الرقم المطلوب الاتصال به عن طريق الدالة 
(6]12(3680. لاحظ أن هذا الإجراء يتطلب إضافة إذن اتصال في ملف الوثيقة (وع؟¡١M2).‏ 


الدالة ()62002]8015م0 (أنظر الكود من سطر 21 إلى 26) يتم فيها فتح قائمة جهات الاتصال 5]ع0142©. 
يتم إنشاء هدف ()مع]م1]) و تحديد الإجراء (40"110171_9712851) وتحديد القائمة المراد فتحها (مثل: 
)content://contacts/people/‏ عن طريق الدالة (602120ء5. لاحظ أن الإجراء (ACTION_VIEW)‏ 
يتطابق مع الإجراء المستخدم لفتح متصفح الإنترنت. تذكر أنه في حالة تطابق الإجراء بين فعاليات مختلفة» 
فإن النظام يستخدم البيانات الأخرى ضمن الهدف (106606) لتحديد الفعالية المطلوب تشغيلها. في هذه الحالة 
»الفعالية الخاصة بفتح المتصفح لها نفس الهدف (407171071_571859) الخاص بفتح قائمة جهات الاتصال 
15 ولكن نوع البيانات المرسلة ضمن الهدف مختلف (في الحالة الأولي يستخدم البروتوكول //:ماغط 
بينما في الحالة الثانية يستخدم البروتوكول //:00266214). لذلكء يستخدم النظام نوع البيانات للتحديد الإجراء 


الصحيح. 


الدالة ()/و40716مءم0 (أنظر الكود من سطر 28 إلى 32) يتم من خلالها تشغيل الفعالية 
Fren 15115] Activity‏ الموجودة ضمن تطبيق سابق تم إنشاؤه. لاحظ أن الإجراء المستخدم يطابق الإجراء 
المحدد في مرشح الهدف (۲ع)۴1 غ101604) الذي تم تعريفه مسبقا ضمن ملف الوثيقة (371301156) الخاص 
بالتطبيق الآخر. 


الدالة 0مم 14ءمuه1‏ (أنظر الكود من سطر 33 إلى 40) توضح طريقة تشغيل تطبيق آخر. في هذه الحالة 
فإن الإجراء المستخدم يكون من نوع (4071101717_1141117) وهو يعني تشغيل فعالية رئيسية (تذكر أن كل 
تطبيق له فعالية رئيسية واحدة فقط). الدالة غمعومممه0)ء5 تحديد المجلد عع3012م الخاص بالتطبيق 
المطلوب تشغيله وكذلك مسار الفئة (طأهموءيهاء) الخاصة بالفعالية الرئيسية للتطبيق. الأمر 
et ۴1ags)1ntent.FLAG_ACTIVITY_NEW_TASK)‏ يعني أن الفعالية سيتم تشغيلها كتطبيق 
مستقل غير مرتبط بالتطبيق الحالي. 
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أسئلة على الوحدة الرابعة 
1. ما الفرق بين الهدف الصريح (10]6016 11016م28:2) والمضمن (٤۸عاہ!‏ 11016م122)؟ ومتى يستخدم كل منهما. 
2. ما هي المكونات الأساسية التي يتم تعريفها داخل مرشح الهدف Filter)‏ Intent(؟‏ 


3 ماذا يحدث إذا كان هناك فعاليتان (411731165) لهما نفس نوع الحدث (40012) داخل مرشح الهدف 
Filter)‏ Intent(؟‏ 

4. قم ببناء تطبيق مكون من فعاليتين (401171165) كما هو موضح بالشكل. الفعالية الرئيسية على اليسار تحتوي 
على زر "0101065" عند النقر عليه يتم تشغيل الفعالية على اليمين. يقوم المستخدم من خلال الفعالية الجديدة 
باختيار هوايته المفضلة من ضمن مجموعة من الخيارات الأخرى (يسمح باختيار واحد فقط). عند النقر على 
زر ")0" ضمن الفعالية الجديدة يتم إرجاع الإختيار إلى الفعالية الرئيسية وعرضه ضمن عنصر عرض 
(1619/1697). عند النقر على زر ”66و26“ يتم حذف النص المكتوب ضمن عنصر العرض 
.{(TextView)‏ 


StartActivityForResult Study StartActivityForResult Study 


Running 
Biking 


Swimming 
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رقم المقرر 
الوحدة الخامسة: 
القوائم وشريط العمل 
(Menus and Action Bar)‏ 
يتعلم الطالب في هذه الوحدة: 


”7 أنواع القوائم المختلفة في تطبيق الأندرويد (قائمة الخيارات 1م71 كرمنام0» قائمة السياق 
Content Menu‏ والقائمة المنبقثة) واستخداماتها. 


> إنشاء القوائم المختلفة برمجياً وربطها بالتطبيق 
”7 تهيئة شريط العمل (1ه8 80100) والتحكم به برمجياً. 
”7 إنشاء درج التصفح (101251 71371536102) وربطه بالتطبيق 


القوائم 741615 من المكونات شائعة الاستخدام في تصميم واجهات التطبيقات. تتطرق هذه الوحدة إلى الأنواع 
المختلفة للقوائم وطريقة إنشائها. 


(Action Bar) وشريط المهام‎ (Options Menu) قائمة الخيارات‎ 


تستخدم قائمة الخيارات 7/111 1055)م0 عادةً للوصول إلى الإجراءات العامة التي يتطلب الوصول إليها كثيراً 
أثناء استخدام التطبيق مثل إجراء البحث طء۲هم؟ والإعدادات وع0غ]ء5. (ابتداءَ من اصدار أندرويد 3.0 ۸۴1 
(11 16761 يتم تضمين قائمة الخيارات ضمن شريط العمل (1ه8 8108). يقوم النظام تلقائياً بإضافة عناصر 
القائمة الخيارات (Options Menu)‏ إلى ملحق شريط العمل المسمى (/01:611101 40]1012) (أنظر شكل 5.1). 
لا تظهر عناصر القائمة تلقائياء حيث يمكن عرضها بالنقر على اللإيقونة على يمين شريط العمل. يمكن أيضاً إظهار 
قائمة الخيارات بالنقر على زر "1م716" إذا كان الجهاز يوفر مثل هذا الزر. 


لإنشاء قائمة اختيارات Mu‏ 00]1005) لفعالية معينة (رازذاءA)ء‏ يمكن في البداية تصميم محتويات القائمة 
خارجياً باستخدام .752411. على الرغم من إمكانية بناء محتويات القائمة برمجيأء إلا أنه يفضل تصميم القائمة 
باستخدام :]704 وحفظها في مجلد المصادر, يمكن يعد ذلك إنشاء القائمة عند تشغيل الفعالية عن طريق الدالة 
()1011361.121136. إنشاء القائمة في ملف ,502411 يتيح إمكانية فصل تصميم القائمة عن عمل التطبيق. كما يتيح 
عمل إعدادات أو تصميمات مختلفة للقائمة بناءً على إعدادات الجهاز المختلفة مثل حجم شاشة العرض. كما ذكرنا 
في الوحدة الثالثة يمكن مواءمة التطبيق مع الإعدادات المختلفة عن طريق حفظ وترتيب الملفات الموجودة في 
مجلدات المصادر. 


لتصميم قائمة خيارات جديدة؛ قم بإنشاء ملف ,5311 جديد في المجلد /1ع252/وع7 وقم ببناء القائمة داخله. الملف 
التالي 203'_206111.171 يوضح مثال لتصميم قائمة خيارات: 
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mM ue كت شه‎ NOL د 6 2ع - تك هك كرت‎ 
<menu 
MIMS : 212 01126 10-7 6 65 : / / SCMeMa sS. ARSAEOL GA. COM/ABKR/ EES ARAEO ALS 
<item android: id="@+id/ucas_ homepage" 
android:icon="@drawable/ucas_ logo" 
android:title="@string/ucas_ homepage" 
android: showAsAction="ifRooOom"/> 
<item android:id="@+id/help" 
android: i1con="@drawable/ic help" 
ARIFO GA SENE le 0-5 AMeE LG > 


</menu> 


2 1 جا‎ = Action Overflow 


a Refresh 


New tab 

New incognito tab 

el olelel aL ELLES)‏ تالت 
Bookmarks‏ : 

EEG Ele GC 

تلماه لواف Ine‏ 


ات CEI Je‏ اتا" “حلم 


Save for offline reading 


شكل 5-1: قائمة الخيارات (OptionsMenu)‏ 
كما هو موضح في المثال» تصميم القائمة كاملةً يكون ضمن الخاصية <216211> والتي تحتوي على عنصر أو أكثر 
من الخصائص <«ع)1> والتي تمثل عناصر القائمة. الخاصية <صع)1> تستخدم لبناء عنصر القائمة 
.(Menultem)‏ 


من داخل الخاصية <70ع]1> يتم تعريف شكل عنصر القائمة (صع) آم6 )M‏ باستخدام الخصائص التالية: 


رك الكلية الجامعية للعلوم التطبيقية 


android: 4d‏ : وهو يحدد رقم معرف ((11) خاص بعنصر القائمة (7161116672). الرقم المعرف (112) یمن 
التطبيق من معرفة عنصر القائمة (Menultem)‏ الذي تم النقر عليه» حيث كل عنصر قائمة له معرف خاص 
به 


ء 800010:1608 : وهو يضاف إختياريا لتحديد صورة الأيقونة الخاصة بعنصر القائمة. يجب أن تكون هذه 
الصورة ضمن مجلدات 01858616. 


»ه 32011010:116: وهو يحدد النص المعروض في العنصر. 


® ndroid:showWwAsActionه:‏ وهو يحدد كيف ومتى يظهر عنصر القائمة ضمن شريط العمل 0]0ى) 
.Bar)‏ هناك قيم مختلفة يمكن تحديدها لهذه الخاصية مثل القيمة "118001" وذلك لإظهار عنصر القائمة 
ضمن شريط العمل إذا كان هناك متسع به وكذلك القيمة "۲ ع۷رعم" لعدم إظهاره ضمن شريط العمل» والقيمة 
"always"‏ لإظهاره دائماً ضمن شريط العمل 


تمثل هذه أهم الخصائص التي ينصح باستخدامهاء ولكن هناك العديد من الخصائص الأخرى التي لن نتطرق لها في 
هذا الكتاب. 


يمكن أيضاً إضافة قائمة فرعية (submenu)‏ داخل أي عنصر في القائمة (Menu)‏ وذلك بإضافة الخاصية 
11> ضمن الخاصية <رررء)1>. القوائم الفر عية (1061115ط511) مفيدة في حالة تعدد وتفرع الإجراءات التي 
عنصر قائمة: 


GDN wor د 6 622 - لكات ك ك كت 017 :1ن مت له‎ 
<menu 
SMUT S E 2101126 1 017 "16 68 E //SCMemMa SARA EOLG . ل 1ت‎ S1 ARSE OGL 
<item android:id="@+id/file" 
ARIES EEE Ke > LE SEDO E EL > 
e EE SOMER حت‎ 
<menu> 
<item android:id="@rtid/creale new" 
android:title="@string/create_new" /> 
<item android:id="@+id/open" 
android:title="@Gstring/open" /> 


< /menu> 
VT ECEME 
</menuz> 


بعد تصميم قائمة الخيارات (u,«عM‏ 6025م0) يتم استخدامها في الفعالية (4211971077) عن طريق الدالة 
Menunfater. inflate)‏ والتي نقوم بتحويل التصميم في ملف ۷1× إلى عنصر واجهة يتم الوصول إليه 
برمجيا. يتم كتابة الدالة ()111ع/0200626606110051» وهي أحدى الدوال الموجودة ضمن الفعالية (راإActv)‏ 
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والتي يتم تنفيذها تلقائياً عند إنشاء الفعالية» وذلك لبناء القائمة من ملف ,5111 باستخدام الكائن Menul1nflater‏ 
كما هو موضح: 
@GOverride‏ 
public boolean onCreateOptionsMenu (Menu menu) {‏ 
Menulnflater inflater = getMenuInflater ();‏ 


me a E CE in f aE ت‎ (E men UE my MERU, MERU) 
E E كنا‎ EEO 


(Handling Click Events) معالجة أحداث القائمة‎ 


عندما يختار المستخدم عنصر من قائمة الخيارات (Options Menu)‏ (بما فيها العناصر في شريط العمل 
»)Action Bar‏ يقوم النظام بتنفيذ الدالة ()0ع16ع11005166525616م020 والتي يمرر لها عنصر القائمة 
0ت الذي تم اختياره (أنظر الكود بالأسفل). يمكن تمييز هذا العنصر عن طريق تنفيذ الدالة (6]]]677100ع 
والتي ترجع المعرف 17 الخاص به والمنشأ باستخدام الخاصية 201010:10 في ملف ,7341 الخاص بتصميم 
القائمة. بعد معالجة الحدث يتم إرجاع القيمة عنت). إذا لم يتم معالجة الحدث يجب تنفيذ الدالة 
n0 ptionstem Selected)‏ الموجودة في الفئة الأم (و610185م50). 


@GOverride 
public boolean onOptionsIlItemSelected (Menultem item) { 
// Handle item selection 
switch (item.getltemId()) { 
Sa SE RE TE mew Game: 
newGame )( م‎ 
12 ملاع‎ EE UO? 
Sa Sê REA He NE: 
showHelp (); 
ia E I EEE 
EEE AEE 
return super.onOptionsItemSelected (item) ; 


/ 

يوفر نظام أندرويد أيضاً إمكانية تعريف دالة لمعالجة حدث النقر ع1ن1[ه من خلال ملف ,75311 الخاص بتصميم 

القائمة باستخدام الخاصية ع1[ع3011010:010'11. القيمة التي تأخذها هذه الخاصية هي اسم الدالة التي تعالج الحدث 
والتي يجب تكون عامة ع1[طنام ويمرر لها متغير من نوع إٍع)MenulI.‏ 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
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كما ذكرنا مسبقاًء يتم إنشاء القائمة رع من خلال الكود الموجود في الدالة .onCreateOptionsMenu()‏ إذا 
أردت تعديل محتويات القائمة بالإضافة أو التعديل أو الحذف أثناء عمل الفعالية (/4510)» يمكن القيام بذلك من 
خلال الدالة u)(‏ ىء nPrepare0ptionsMد.‏ هذه الدالة يمرر إليها كائن من النوع سمه" والخاص بالقائمة التي 
تم انشاؤها مسبقا في الدالة ()1 1ع SM‏ 10ام 0ء Creat‏ nه»ء‏ حيث يمكن التعديل عليها بالإضافة أو الحذف. 


(Context Menu) قائمة السياق‎ 


قائمة السياق امع[ غء]002) يتم من خلالها تنفيذ الإجراءات التي تؤثر على عنصر محدد في واجهة المستخدم. 
يمكنك ربط قائمة السياق ع7 0016 بأي عنصر واجهة ع۰۷1 ولكن غالبا ما تستخدم لتنفيذ اجراءات على 
العناصر في القائمة (/15]97161.]) أو (61105/161)»: أو غيرها من عناصر عرض المجموعات التي يمكن 
للمستخدم تنفيذ إجراءات مباشرة على كل بند فيها. هناك طريقتان لعرض قائمة السياق (1امءع]81 غ2ع]0021)؛ كما 
هو موضح بشكل 5-2» وهما: 


Context Menu ®‏ 0atingاR:‏ حيث تظهر كقائمة عائمة عندما يقوم المستخدم بنقرة وطويل على عنصر 
واجهة 7/1690. باستخدام هذا الوضع Context Menu(‏ atingدا۴)»‏ يمكن تنفيذ الإجراءات على عنصر 
واحد فقط في الوقت الواحد. 


هه :Contextua1 Action Mode‏ وفيه يتم عرض عناصر القائمة (716111)»التي تؤثر على العنصر الذي تم 
اختياره »ضمن شريط العمل (831 40]102) في الجزء العلوي من الشاشة. عندما يكون هذا الوضع مفعلاًء 
يمكن للمستخدمين تتفيذ إجراء: على عناص متعددة في رقت واحد (إذا كان التطبيق الخاص بك يسمح بذلك) 
(لن يتم التطرق للقوائم من نوع 11006 10۸اAc‏ 00216210131 في هذا الكتاب). 


Henry IV (1) 


Henry V 


Henry VIII 


Edit 


Richard ااا‎ 
Share 


Merchant of Venice 


Delete 


Othello 


King Lear 


شكل 5-2: قائمة سياق عائمة Men u(‏ )»200126 171021126) على اليسار» وشريط عمل السياق 
Action Bar)‏ اontextua€)‏ على اليمين. 
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إنشاء قائمة سياق عائمة (Floating Context Menu)‏ 


يتم إنشاء قائمة السياق العائمة Men u(‏ 0012166 1103128) باستخدام الخطوات التالية: 


1. كما ذكرنا مسبقاًء قائمة السياق العائمة ترتبط بعنصر واجهة (171600) محدد وتظهر عند النقر عليه. عنصر 
الواجهة (سمز۷) المراد ربط قائمة السياق (nuصMe‏ )2ء6)م00) به يجب تسجيله بتنفيذ الدالة 
register ForContextMenu)‏ ضمن الفعالية (4211071]7) وتمرير العنصر (wعا۷)‏ لها. إذا كانت 
الفعالية (/إ4.2001916) تستخدم قائمة عرض (/11569161]) وأردت استخدام نفس قائمة السياق 0216© 
Menu‏ لكل القائمة (2)]1156771607» يجب في هذه الحالة تسجيل القائمة (1.156771687) بتمريرها للدالة 
.registerForContextMenu()‏ 


2. يتم كتابة كود في الدالة u)(‏ ىء x†M×ءعreateCont on‏ والموجودة ضمن الفعالية (راز]ءA).‏ يتم من خلال 
هذه الدالة إنشاء القائمة من مصدرها في ملف ,5311 وذلك باستخدام كائن من نوع 71621112141361 كما هو 


@GOverride 
public void onCreateContextMenu (ContextMenu menu, View 77, 
COR Eex EMenmu IRE O men UunRE O) 
super.onCreateContextMenu (menu, v, menulnfo) م‎ 
Menu IME later inflate  GEEMEMUIN Ela EOE )( : 
im ake E im alle ) mem. COM EEE MENU, Meu) 


لاحظ أن الدالة 0م on reateContex|M‏ يمرر لها »بالإضافة للقائمة »)€contex|Menu(‏ العنصر View‏ 
والذي تم اختياره لتفعيل قائمة السياق Menu)‏ 6<ه6]م060) وكائن من النوع 
2111111110 والذي يحتوي على معلومات إضافية خاصة بالعنصر الذي تم اختياره. 
هذه المعلومات يكم استخدامها إذا كان هاف عاضر وا۷ م وكل متا مرقظ شف سان اود 
Men‏ مختلفة. في هذه الحالة تفيد هذه المعلومات في تحديد القائمة التي يجب إنشاوؤها لكل عنصر عرض 77161. 


3. كتابة كود الدالة ()ع)ءع1عءn¬Sءxt[tعont€nه‏ ضمن الفعالية ((401197109) وذلك لتحديد الإجراء المراد 
تنفيذه عند النقر على أي من عناصر القائمة Menu‏ )2زع0026). المثال التالي يوضح ذلك: 


@GOverride 
PUI كت‎ Boolean OMCON EEE 1 عا‎ 101521626241 (MemU LEemM iEem) | 
AdapterContextMenulInfo info = (AdapterContextMenulInfo) 


item.getMenulnfo )( م‎ 
:10ت 2 1د ) كلت ع داه‎ GEE 6 كلت‎ )( ( 1 
CASE kı, 116 7 CCE 
6ك‎ ENOEe (IME OE) 
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122 CUE EUS 
609526 RS OE EEE 
0611252116524 ) 255 EOE 
e HEM EEE, 
default: 
عر‎ EER SUPE. ORCOM ECS ELE 205211226 ECM) 


(Popup Menu) القائمة المنبثقة‎ 


أعلاه إلى لم تتوفر مساحة لعرضها) كما بشكل. القائمة المنبقة (uمرع×‏ منام0) يمكن أن تستخدم في الحالات 
التالية: 


(83 مهنع ى) يتم اظهار قائمة منبثقة تتضمن مجموعة من الإجراءات. 


2. إظهار قائمة من الإجراءات التفصيلية التي تتفرع من إجراء أساسي. فمثلاً» عند النقر على زر "إرسال"», 
تظهر قائمة منبثقة من إجراءات "إرسال" أخرى مثل إرسال إلى الجميع» إرسال إلى صديقء إرسال إلى 
مجموعة؛ وهكذا. 


| ات‎ 
Popup 
Menultem1 
Menultem2 


ELGG] 


شكل 5-3: القائمة المنبثق (Popup Menu)‏ 
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الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


لاحظ أن القائمة المنبقة متوفرة في“إصدار أندرويد 11 1.661 ۸۲ وما بعده. 

إظهار القائمة المنبثقة (1ااع7)1 منام20) يتم بالخطوات التالية: 

1. أنشئ كائن من نوع Mu‏ مںمه۴ بحيث يمرر إلى الباني إماعں)وممء الخاص بها الكائن )6016© 
الخاص بالتطبيق بالإضافة إلى عنصر الواجهة سوس التي يراد إلحاق القائمة به كما هو موضح: 

2. استخدام كائن من نوع 71611111112661 لإنشاء القائمة باستخدام ملف التصميم ,353/1 الخاص بالقائمة. 

3. إظهار القائمة بتنفيذ الدالة .Poupmenu.show()‏ 

على سبيل المثال» الكود بالأسفل يوضح التصميم الخاص بزر 81105 والذي عند النقر عليه يتم تنفيذ الدالة 

.(Popup Menu) والمسؤولة عن إظهار قائمة منبثقة‎ show Popup 


<ImageButton 
311701 :14ت‎ la yOUE dE MS WES OOM EOE 
ARE EO GE ال‎ 55761015 _ 1561© MES ESD CON ECEME 
android:src="@drawable/ic_ overflow _ holo_ dark" 


android :COntentDescription="ECstring/déescr Overflow BDULtLON 
android:onClick="showPopup" /> 


الكود التالي يوضح الدالة ()م1ام5101:20 داخل الفعالية (رtز])Act):‏ 


public void showPopup (View v) { 
PopupMenu popup = new PopupMenu (this, v); 
Memnu جرس‎ lale Inflate POPUP SeEMenULRE later (J; 
inflater.inflate (R.menu.actions, popup.getMenu ()); 
هات هل سرهم‎ )( 

/ 


ملاحظة: إبتداءَ من الإصدار 14 1٥۷م‏ ۸۴1 يمكن استخدام الدالة ()7/16110.18412]6منام20 بدلاً من استخدام 
.Menulnflater.inflate()‏ 


لتنفيذ إجراء معين عند النقر على أي عنصر في القائمة المنبثقة مںمه۴ يجب إنشاء مستمع (إععاءز1) من نوع 
MenuPopupMenu.OnMenultemClickListener‏ وتسجيله باستخدام الدالة 
Listener)‏ ickاupMenu.setOnMenutemCمPop‏ ومن ثم كتابة كود الإجراء المطلوب في الدالة 
nMenutemC1ick0ه.‏ الكود التالي يوضح هذه الخطوة: 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 


public void showMenu (View v) { 
PopupMenu popup = new PopupMenu (this, v); 


popup.setOnMenultemClickListener (new 
OnMenultemClickListener )( { 


GOverr1de 
public boolean onMenuItemClick (Menultem item) { 
switch (item.getltemId()) { 
©2652 REA ACE MEE 
archive (item) ; 
املاع قا‎ E EE, 
Case Rid 2612-2 
de lee (1 ECEM) 
لا كان سكا‎ EEE 
default: 
ae E IAM 2-7 


] 
]ا 


popup.inflate (R.menu.actions) , 
BOBBIE Se O 


تمرين عملي (5-1) 


يهدف هذا التمرين إلى التدريب على إنشاء أنواع القوائم (وuرع)‏ المختلفة التي تم تفصيلها سابقاً في هذه الوحدة. 
واجهة التطبيق والقوائم التي يتم عرضها موضحة في شكل 5-4. يستخدم التطبيق قائمة خيارات 1005ام©) 
(ناء31 تظهر في شريط العمل (..,2 «0نامه ,1 005م0) بينما تظهر بقية العناصر عند النقر على أيقونة 
Action Overflow‏ أو النقر على زر "نم۷" في الجهاز. 


تحتوي واجهة التطبيق على زرين: "Show Popup Menu" ›"Show Context Menu"‏ عند النقر عليهما 
تظهر قائمة السياق (1جء71 )2ء006)) و القائمة المنبثقة (1امع241 م1ام20) كما هو موضح في شكل 5-4. عند 
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الكلية الجامعية للعلوم التطبيقية 


81 Menu Test OPTION1 OPTION 2 


show Context Menu 


show Popup Menu 


Context 1 


Context 2 


Context 3 


Option 3 


عنوان الكتاب 


رقم المقرر 


gl Menu Test OPTION1 OPTION 2 


show Context Menu 
show Popup Menu 
Popup 1 
Popup 2 


Popup 3 


شكل 5-4: واجهة التطبيق الخاص بتمرين 5-1: قائمة الخيارات uر٥M‏ 2071410125 تظهر في شريط العمل 
Action Bar‏ (يمين)» قائمة السياق Context Menu‏ (وسط). القائمة المنبثقة Popup Meu‏ (يسار) 


تصميم الواجهة الرئيسية (/3/1310/4115710) موضح فيما يلي: 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
كت 5 / / 2 665 5 ده لهت 2 : 155 اناد‎ 221012-57 7 ARO ASAS 1ت‎ EOS 
تنك لت‎ OG a OU E GE MS MAEM الست تم‎ 
AMEE OMG E AOE MEMO MES 2 ام‎ OAC 
android:paddingBottom="@Gdimen/activity_vertical_ margin" 
android:paddingLeft="@dimen/activity_ horizontal _ margin" 


android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
tools:context="com.example.menutest.MainActivity" > 


E E TRACOM EC SSE E E 

SMO GE ERSNI EAD COMIC E 
La woul _ MOLEC ALESIS CORES E 
MOE SSR ES EEN E ROE EEE 
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SEM 5 لك‎ 


2220 
android: 
2101 
ANIC; 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 
١‏ لت CE SAS‏ 2 رت AEE OG E ES OU E‏ 


android:text="show Context Menu" 
android: layout_marginTop="30dp" /> 


SBE 6 6 
"852متامهم /84+30"-10: 02010 طة‎ 
2ت ملك الث‎ 161 E LE 1015 تا ك1‎ EES COM الست‎ 
1615و قتامصة‎ LAVOE _ 156210157322379 55 
22102010 : layout_below="G@+id/contextBtn" 
61:251615ملة‎ a VOU E _ ا 116112105 1ك الكت‎ 
android:text="show Popup Menu" 
android:onClick="showPopup" /> 


</RelativeLayout> 
ملفات 1× الخاصة بالقوائم الثلاثة موضحة فيما يلي:‎ 


أولاً: قائمة الخيارات (Options Menu)‏ 


//options_menu. xml 
<?xml version="1.0" encoding="utf-8"?2> 
<menu 
xmlns:android="http://schemas.android.com/apk/res/android™ 
2 

>11 11ت ع‎ AMARONE 12 0 OAC EN OM 2 ست‎ 14 2 61 611 LOB ESM 
1" android:showAsAction="ifRoom"></item> 
SEEM 2160261-60: 1 ASL CT 6 / 6م‎ ORAL AROEOSA GA: EE e > 5 
2" android: showAsAction="i fRoom"></item> 
417 6 10ت‎ ARA EOE SAL CT OAL OBES SL ARO EO 2 EEE > OP 6 OM 
3" android: showAsAction="i fRoom"></item> 
</menu> 


ثانياً: قائمة السياق (Context Menu)‏ 


1/1 ل ل‎ MON U aml 
SSL TEE SOM N OL لانو 8 عن الاكرو 0 امرق هع هرت‎ 
<menu 
xmlns:android="http://schemas.android.com/apk/res/android"™ 
> 
< EeM AMA EOLA: ALC AA عت وت‎ E "2 11ت‎ 01-0 EE e > EOI e E 
10 AEE 
ECM 227626 1261: 12 LC AACE SEZ Û 2 6ه كت‎ E ات للع 1 ع‎ SE 
2 ECEM 


5 
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GES 1ه :61262161 2ك‎ CE 14 عدت ع مهت‎ 2 5177 EME SMEG 2 EE NE CSM ECESE 
JN ITEM 
< /melnUuz> 


ثالثاً: القائمة المنبثقة (Popup Menu)‏ 


SL ue Si OM I OL فتك مك كرت‎ UE E 85 2 
<menu 
xmlns:android="http://schemas.android.com/apk/res/android™ 
> 
<item android:id="@+id/popupl" android:title="Popup 
> 16 لت‎ 
الك 1د‎ AMdEOILA EAS LC د ام ادرو امات 17 2ه ناه كرو رأ‎ EEL POU 
23/1 8 12ت‎ 
ECM نت لت 12ت‎ SLO LCT 16 5618-5 1 :ك1 2 لديا > 116 ه عات 10ت‎ 8 56 
S> ECM 
</menu> 


:MainActivity) الكود التالي يوضح الفعالية‎ 
BUC INE CIS SS MSNA EUT EY CEERI S LACE A E 


@GOverride 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
SEE CORMIER سات‎ (E AYO UE aC E Ey MA A) 


CER EME COMNEEXE Menu‏ للا تت تت 6 لكت تع 56 EREN ENE‏ م 
EN > (BUEEOM)‏ عدت 515 EME EON‏ 

ES EE MROV EWEY LCE (RTE COR 6 8ع كدت‎ ER) 
EMIS كات فا عدت عا 11-5 0 2 ك1‎ 46 10 5 CEME ) كلع عدت ع جوت‎ ER) 


| 3ا اكه حن إن وك ال OO‏ كا د 


} 


@GOverride 
public boolean onCreateOptionsMenu (Menu menu) { 


65 EMemU mi 1-5 را : () عت‎ 2 la 62 (RK mMeMU : OBE OMS Menu, 
MERU) 
الهم يناع‎ ETE; 


1 لك[ كسمم كم‎ a E O ا‎ RA 


: 5ه كت ]| دجا شن كذ ار دك ل 62 OOS‏ 


0 ا‎ ١ 


} 
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عنوان الكتاب 
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1 061752 3 َك 
eM ECM) |‏ 2 11 رت11) le CECA‏ 12ت 6 11 15ت 1 BOOLEAN OMOSE‏ 111 هلاه :235 


24: كات ع داه‎  ) 126 2101 GEE لك كات ع‎ OD 

25 SSE RO OBEROI 

208 1795 516 Mma Ke Rese (ERS, ODEON 1 SEES, 
27: 1155 عت‎ LENGE TONE) SRO OE 

298 EE MER EEE 

E‏ 1513 عا كره SESE REMO‏ و2 

SOE 1163 5162 EMA RE REE (EAS, OSE OM 2 SENECA, 
31 Toast. LENGTH LONG) .show(); 

S28 BEE EN EME, 

55: ©2525 1: 114 OSE 2 25ت‎ : 

54: 1269 55 21092122 Ne E (ERAS, 64ت لتك © لكت 1ت"‎ 
EE Toast. LENGTH LONG) .show(); 

1-7 لصاح ا :56 

SE default: 

385: 126 تت للدت 15ت 2 11 15ت 11 عا 90136 2 16ت 015 5 1ل 1 عا‎ ECO (ECM) 

35: } 

40: } 

41: 

42: @Override 

43: public void onCreateContextMenu (ContextMenu menu, View 
44: vy, Conte EMenUunf O Menu IME O) 

45: super.onCreateContextMenu (menu, v, menulnfo) م‎ 
4G 81515 6 616 2! رك : () عدت 2ت 211 2:0 ك1‎ 21-2 823 (RE Me RU. COMIEeGE MOM, 
471: menu); 

A48: } 

49: 

5O0: _ COxuerrI de 

(MERU 210 ECM) |‏ 6ت 6 6ت للدت 15ت 2 011 عت 5 511861 Coolean‏ 1511م :511 
switch (item.getltemId()) {‏ 52 

53 ©9525 REO COM 1ك‎ 

542 Toast.makeText (this, "Context 1 selected", 
55 Toast. LENGTH LONG) .show(); 

56 لطاع‎ EEE, 

SE CASE EES 7 62 

55 : Toast.makeText (this, "Context 2 selected", 
50 Toast. LENGTH LONG) .show(); 

OE EAE MiN EUS 
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رقم المقرر 
COREE EOE‏ :14د O1 ©3525 KR.‏ 
Toast.makeText (this, "Context 3 selected",‏ 525 
ROA SE HENG EON SRO )‏ 685 
return true;‏ :64 
E EU E £‏ 65 55 
(LEC) 7‏ 6266 تك ت للدت 15ت 2 1 E‏ 2ك 2 915-017 2 16ت 015 5 211 لاا 126 :66 
} :6 
Og: J‏ 
9 
public void showPopup (View view) {‏ :70 
PopupMenu popup = new PopupMenu (this, view);‏ 118 
popup. setOnMenulItemClickListener (new‏ 128 
OnMenultemClickListener )( {‏ :73 
:74 
ع0 221 م0177 0 15 
ACK (MEMNUN 6‏ 41 اكت 2 1 210 621:1 Soolean‏ 15 ل وناك :16 
1 ال 778 
1 (() لات ع 1 ع ECM ) 1 20101: Ge‏ لزه :718 
R.1 POPUP LE‏ 3586© 198 
:500 


OF 25515‏ عدت 2 15146012 26ت 1 لله كسك 5 0) 6ت 0201218 7 565 1255 SME‏ 
EONE) CSO )(‏ الت لظ 6 285586 5212660647 :2ق 


55: BE EU EUEY 
84: CASE 15 116 5255052 E 
85: 


GE 1269506 7 202192 هر مت عاك و ) 6ت‎ INCA E 29252 Ee E), 25505 2 
578 2 861686 63618 MOSSE ENE EONS هاه د‎ OE 


88: HEE HED 0 
89: Ca Sê RE. 14: POPUPS: 
50 


SE 65-5 Male ع ست 8ت 1 ع دك درم عات 0 ) عدت‎ ESSE )( | IBO © 
2S 561-626 MOSSE. LENGTH LONE) SOW 


595: return true; 

94: EEE aE 

95: 125 201120 false; 

520 } 

5 } 

98: 8 

558 MenulIlnflater inflater = popup.getMenulInflater )( ; 
OE IL 21ل‎ 5312 ¢ IML LACS (RK. MERU . OSS _ Menu, 
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101: popup.getMenu () ) م‎ 
1028 popup.show(); 
1938 1 
104:} 


لاحظ أنه في الدالة ()02006266 عند تشغيل الفعالية» يتم الوصول للزر "602611105" وربطه بقائمة السياق 
عند طريقة الدالة re ister ۴0۲٣00 )ع×†1M e u)(‏ (أنظر سطر رقم 11). 


قائمة الخيارات Menu(‏ 61055م0) يتم إنشاؤها ضمن الدالة ()10ع10051/1)م00016360 (أنظر الكود من 
سطر 15 إلى 20) ويتم معالجة الأحداث المرتبطة بها ضمن الدالة ()660ع11025116715616م050 (أنظر الكود 
من سطر 23 إلى 40). 


قائمة السياق (1م»721 غ00662) يتم إنشاؤها ضمن الدالة ()0001623]600116:3/16111 (أنظر الكود من سطر 
3 إلى 48) ويتم معالجة الأحداث المرتبطة بها ضمن الدالة ()0ع]ء16 000021616677256 (أنظر الكود من 
سطر 51 إلى 68). 


القائمة المنبثقة (1«0ع7)1 منام20) يتم إنشاؤها ضمن الدالة ()م1ام510120 (أنظر الكود من سطر 70 إلى 103) 
والقى فة عن انر على الزر المخصصن, 


(Navigation Drawer) درج التصفح‎ 


درج التصفح (1(18561 7137183]105) هو لائحة تشتمل على عناصر للتحكم بالتطبيق» مثل الأزرار أو القائمة 
(115]971657)» علي يمين أو يسار الشاشة. تكون هذه اللائحة مخفية تلقائيا ويتم إظهارها عند السحب (عم5171) 
باتجاه العرض (أنظر شكل 5-5). درج التصفح من الأدوات شائعة الاستخدام في تطبيقات أندرويد. 


لإنشاء درج تصفح (17ع101231 2137182105) ضمن تطبيقك» يجب تصميم الواجهة باستخدام تصميم من نوع 
7611230106 . يجب أن يحتوي التصميم على جزئين: 


1. المحتوى الأساسي (51/1657 0026626 «نه1: هذا الجزء يمثل المحتوى الأساسي للواجهة والذي يظل ثابتاًء 
ويجب أن يأتي في الترتيب الأول داخل ملف التصميم. يمكن أن يكون هذا الجزء عبارة عن تصميم (1-235:0100) 
داخل التصميم (1 ۲201ء سه5۲) يحوي داخله مجموعة من عناصر العرض . 


2. محتوى الدرج (]002]65) إم0raw)‏ الجزء الثاني من التصميم 1(7316113(0106 يمثل محتوى درج 
التصفح والذي يكون مخفياً ويظهر عند السحب فقط. يمكن أن يكون محتوى درج التصفح عبارة عن عنصر 
عرض وحيد (مثل سع۷1]ء11) أو مجموعة من العناصر يجمعها تصميم واحد (اامره]) . محتوى الدرج 
يجب أن يستخدم خاصية ۷1> التالية: 72510ع_2201010:1338/00 والتي تأخذ القيمة "مء" أو "0مع". 
هذه الخاصية تعني أن محتوى العرض يقع على يسار الشاشة (7ء“) أو يمينها (”0مع“). كما يجب أن 
يستخدم محتوى الدرج الخاصية 30010:13(901]_11011 لتحديد عرض درج الحوار عند عرضه. لاحظ 
أن درج التصفح يجب أن لايحفي المحتوى الأساسي كاملا عند عرضه. 


5 
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رقم المقرر 
ا EE‏ اه يا 
Gi Lower 1.1 BH 33 App Name :‏ 


KA TopView1 


£2 TopView 2 


9 


TopView 3 
© TopView 4 


E TopView 5 


شكل 5-5: درج التصفح Navigation Drawer)‏ 1 


المثال التالي يوضح تصميم لواجهة بسيطة: لاحظ أن تصميم الواجهة يستخدم 1(123111.29/006. بداخله تم 
استخدام تصميم من نوع 261300976123016 (أو أي تصميم آخر) والذي يجب أن تحتوي العناصر الأساسية 
الثابتة للواجهة (7169١آ‏ 00026626 .)Main‏ الجزء الثاني من التصميم 1(13561133:00]6 هو قائمة العرض 
(11547161) والتي تمثل محتويات درج التصفح. لاحظ أن القائمة تستخدم الخاصية 
.android:layout_gravity‏ 


<android.support.v4.widget. DrawerLayout 


xmlns:android="http://schemas.android.com/apk/res/android™ 

android:id="@+id/drawer_ layout" 

ARETE EG SA OU E اجات 115 ا ك1‎ OA Ee E 

AMEE OG Sa OME Me OMS EMA EEN Oa EEE 

android: theme="@Gandroid:style/Theme.WithActionBar" 

> 

<RelativeLayout > 

EE 556 Mam Ul COMEPOMEMES Meke > 
</RelativeLayout> 


Navigation Drawer, Android Developers, https://developer.android.com/design/patterns/navigation- ' 
drawer.html 
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<ListView 
android:id="@+id/left_drawer" 

LAVOUE GCEAVILC SETAE‏ 21615 عنامامة 
61-250 ك1 la yOUE‏ :0514 01 11ت 
لاست 6 2م MeO MES male RM‏ 16ت 121 ARE EOE‏ 
!1ه ات 1 HEMO 2 51:16 66 >1 SIRS‏ © 1ه عدت 11 5 
android:divider="@Gandroid:color/transparent"‏ 
COLI CE EE LEA E = OCIS 4‏ 1161م مزلت 11ت 
android:background="#111"/>‏ 

</android.support.v4.widget.DrawerLayout> 


ملاحظة: يمكن إدراج المحتوى الرئيسي (سع ۷1 001216246 3413312) ضمن تصميم خارجي يسمى بالقطعة 


)ا۴agmen)‏ ومن ثم إدراج القطعة (٤رعصعهإ۴)‏ داخل التصميم 1(3161338/016. سيتم التطرق للقطع 
(menعها۴)‏ في الوحدة التاسعة. 


تمرين عملي (5-2) 


في هذا التمرين سنقوم ببناء تطبيق معلوماتي عن المساجد الشهيرة في فلسطين وواجهته موضحة في شكل 5-6. 
يستخدم التطبيق درج التصفح (101201 72120718210) لعرض قائمة بالمساجد» وعند النقر على اسم مسجد تظهر 
تفاصيله ضمن الواجهة الرئيسية. درج التصفح يكون مخفياء ويتم عرضه عن طريق السحب من اليمين لليسار. 


لمسجد الأقصى هو مسجد وأحد أكثر المعالم 
قدسية لدى المسلمين في العالم» حيث يعد 
أولى القبلتين في الإسلام. يقع المسجد 
الأقصى داخل البلدة القديمة لمدينة القدس 


في فلسطين. وهو اسم لكل ما دار حول 
السور الواقع في أقصى الزاوية الجنوبية 
الشرقية من المدينة القديمة المسورة. تبلغ 
مساحته قرابة 144 دونماً؛ حيث يشمل قبة 
الصخرة والمسجد القبلي وعدة معالم آخرى 
يصل عددها إلى 200 معلم. ويقع المسجد 
الأقصى فوق هضبة صفيرة تسمى هضبة 
مورياء كما تعد الصخرة أعلى نقطة في 
المسجد» حيث تقع في موقع القلب بالنسبة 


شكل 5-6: واجهة التطبيق الخاص بتمرين 5-2. 
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نقوم في البداية بإنشاء مصفوفة نصوص string-array‏ باسم 20501165_1277 ضمن المصادر تحتوي أسماء 
المساجد لعرضها ضمن قائمة (1.15]1/161]) داخل درج التصفح (10125861 21357182]102). سيتم لاحقا الوصول 
لهذه المصفوفة برمجيا لتعبئة القائمة (15]9/16159]آ). 


<resources> 
<string name="app_ name">Navigation Drawer 
Example</string> 
CSEEIMGAEEAY Mame MOSGUCS SEEAY LY 
<1 tem ع 1/ >المكي الحرم<‎ emص<‎ 
>1 <صه غ 1 / >النبوي المسجد<ررعع‎ 
>1 ا 1 / >الأقصى المسجد<” ما‎ emص<‎ 
>1 >الصخرة قبة<ص ع‎ / 1 temn< 
>1 >الإبراهيمي المسجد<ص ع‎ / 1 tعص<‎ 
<i tem>دجسم /ر>قباء‎ 1 tem> 
>1 ا 1 />العمري الجامع<"‎ em< 
</string-array> 
</resources> 


فيما يلي نعرض تصميم الواجهة الرئيسية والتي تتكون من المحتوى الرئيسيي (تفاصيل المسجد) و درج التصفح 
:(Navigation Drawer‏ 


fact wi Ey MEM o 
<android.support.v4.widget. DrawerLayout 


xmlns:android="http://schemas.android.com/apk/res/android"™ 
android:id="@+id/drawer_ layout" 
:16ت 1ك لت‎ LA VOU WIC MIEN EEO ES 
تلك لت‎ OMG SMa oU E Me OMS Ma ECEM AEE 
android: theme="@Gandroid:style/Theme.WithActionBar" 
> 
SEE O New AMATO LA VOUE WOES LT ae 
1ك لت‎ 05124: 11217515 Men ome iN كت ده‎ 
<RelativeLayout 
11ت عذلك لت‎ 2 AOU E VM GE R> MAEM OA Ee El 
:11ت عذك لت‎ A vOUE Me TOMES MAEM تم‎ eM E 
android:paddingBottom="@Gdimen/activity_vertical_ margin" 
android:paddingLeft="@dimen/activity_ horizontal _ margin" 
android:paddingRight="@dimen/activity_horizontal margin" 
android:paddingTop="@dimen/activity_ vertical margin"> 
<ImageView 
android:id="@+id/imageViewl" 
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E HS OU E VEE MS ESS COM EON El‏ 1ك عذك لت 

AMES E 53ت ال‎ MEGS MES HES COM E CR E 

AMEE 1ه‎ 1 AMOI a ESE ae E ROS E E E 

A YOU E COM EEE OM ZORA LS EEE ll‏ 11ت تنك للك 

aE ©1315 15576105 MSA ORO PDS AE 

android:src="@drawable/ic_ launcher" /> 
<TextView 

android:id="@+id/textViewl" 

AMEE اده‎ 615 E OE _ 1168152 757239 COME EE 

ات مت MESO‏ ع lA VOU E MEO‏ :1ك دك لله 


android:layout_alignRight="@G+id/imageView1" 
android: layout_ below="@+id/imageView1" 


ARMOEOLES LAVOE _ 612 57ت‎ 1.55/11 EEREOE _ 17516 1ق‎ || AGA 
كدت 16ت‎ E 2252652122056! 
م21 0ت 2170115 11 :174 تك لله‎ 0 
3120115 تع :6ت‎ > Nex EVA "لت‎ 7> 


</RelativeLayout> 
</ScrollView> 
<ListView 
android:id="@+id/right_drawer" 
MAE 51415 ال‎ 25761015 OSES UE y> EE 
:11ت عذك الت‎ LE VOUE_ WAC 2 
عست تم اجات 2 116152-06 6 1121715 1141 ك مك الت‎ 
2116112 OLO 4EM OL 221:16 612 >1 5 1:29 211 11ت‎ 
ARSE OLS EAE = 0556120 1 AE 261 1 / SPARED 
and EOLE EEA 16112156 1 CA = OCIS 
android:background="#111"/> 
</android.support.v4.widget. DrawerLayout> 


لاحظ أن التصميم السابق (اuا0ره]إمسهإ5)‏ مكون من جزئين: الجزء الأول هو التصميم 501011571617 
ويحتوي داخله على تصميم 18613017617161 يضم عناصر العرض 121286171617 و 16]17161'. العنصر 
1377 يستخدم لعرض صورة المسجد بينما العنصر 16577160 يعرض معلومات عن المسجد. الجزء 
الثاني هو قائمة العرض (1.15]71617) والتي تستخدم الخاصية ””0مء”*-873515_غ320010:133:011 وذلك حتى 
يتم اخفاؤها في يمين الشاشة. 
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الكود التالي خاص بالفعالية 107167ا71310/6 والتي يتم من خلالها إنشاء الواجهة ودرج التصفح ومعالجة الأحداث 
المختلفة 


PUC IE CESS MESSAGE EY 5ك عع كدت‎ LOE NEY 
private DrawerLayout mDrawerLayout; 
private ListView mDrawerList; 
private ImageView mosquelImage; 
private TextView mosqueDetails; 
private String[] mosqueNames; 


@GOverride 
protected void onCreate (Bundle savedInstanceState) 


EOE GO IA SS OE OSS ) 


super.onCreate (savedInstanceState) م‎ 
586 E هق ع مره‎ 11811 ER 21 61ت‎ a CE Ey MAT) 


106 8 8ع2ئتة لاعن ن‎ > 
JE EE 5ت‎ 61112635 (ESE عل ت‎ ENE ساك‎ 2 AV (E AEA 116 5615-5 AE EA) 
mDrawerLayout = (DrawerLayout) 
findViewById(R.id.drawer layout); 
mosqueIlImage = (ImageView) 
E IMOVIE 7L (ER. LE, 102 لت ات‎ 7 
mosqueDetails = (TextView) 
findViewById(R.id.textViewl); 
mDrawerList = (ListView) 
ك1 عع لك ك6‎ (KR. LE. ACA CESS) f 
mDrawerList.setAdapter (new 
AEA ATS عت 516 ت‎ > 0 EERO CES EE 112160127 عاك‎ 2 e SE ME em, 
mosqueNames) ); 
mDrawerList.setOnItemClickListener (new 
ListView. Onl 6 911111 دكت 1-5 كلت‎ )( ||! 
@GOverride 
public void onltemClick (AdapterView<?2> 

PaAEeM Ey ew ev, MME COSTELLO, LORS O) | 

MDE AWE EU 5 16 SEE U ECM CERE CEES (POSH ELON, EEE), 

String mosqueName = mosqueNames [position]; 

setTitle (mosqueName) ; 

1f (mosqueName.equalsIgnoreCase ) 

) ©0112 5 111301 ا » 5 . ©:0 1113 mosque‏ 
ESE EES )7 2‏ 5 1 لكات عات ظات 0 1290-5 


Old GSO حجر يل‎ UNH O امه وه وم 6ه‎ ae هه هه‎ oe ne 


ىا 


| لشم نتم كم لحن ل بكن جك حمر ويك وي 1ك 
فى )| 0 


N 
6 


SS‏ 3< 3 3 3 تفى) ذن) دنا ()) ذا ذن) 03 ف 
حا انك دك الل GCG GO‏ لله BDH‏ لغ IOS ONE‏ 


{ ) ("المسجد الأقصى" 
R.drawable.aqsa);‏ 
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{ ( ("قبة الصخرة" ) if (mosqueName.equalsIgnoreCase‏ ©5 1ع( :55 
م YE mosque Image.setlImageResource (R.drawable.dome)‏ 
SEE eS yy‏ 5 لنت ع هات 01 11555 :40 
} 41 
م (mDrawerList)‏ 2 12377 ©0105 . 2137570111 101012317 42 
( :43 
445 
ActionBarDrawerToggle mDrawerToggle = new‏ :45 
ActionBarDrawerTogg le (‏ 46 
EAL,‏ 47 
mDrawerLayout,‏ :48 
ale EAE E,‏ 61168512195018 !1 :49 
OBE‏ 16ت 1ت OE E SE ENE CE‏ 
E J)‏ 
public void onDrawerClosed (View view) {}‏ 52 
E‏ 
public void onDrawerOpened (View drawerView) {}‏ : 54 
2 :55 
mDrawerLayout.setDrawerListener (mDrawerToggle) ;‏ :56 
) 57 
55 


في الدالة ()ع]020168 يتم الوصول لمصفوفة الأسماء /120501165_21323 عن طريق الكود التالي: 


getResources0.getStringArray(R.array.mosques_array);‏ = 220501061131065 (أنظر سطر رقم 
14). ومن ثم يتم تعبئة القائمة 15.آ11(185861 عن طريق استخدام 161م41123:83 (أنظر سطر رقم 24). بعد 
ذلك يتم الاستماع لحدث النقر على عناصر القائمة باستخدام الدالة )۲ع ع1ic)¡stاC set 0n tem‏ وكتابة الدالة 
temC1icke0اnه‏ (أنظر الكود من سطر 27 إلى 30). الإجراء الذي يتم تنفيذه عند النقر على القائمة هو تغيير 
عنوان الفعالية بتنفيذ الدالة ()56]1516 وتغيير محتوى 1512867168 و 161/1687 لعرض معلومات عن 
المسجد الذي تم اختياره (أنظر الكود من سطر 32 إلى 41). كذلك يتم إخفاء درج التصفح (Navigation‏ 
Draw)‏ عن طريق الدالة :()2ع29(0111.6010561013آ1ء:1(1355 (سطر رقم 42). 


يمكن كذلك الاستماع لأحداث فتح وإغلاق درج التصفح (112517 2م0)وع2]371) عن طريق الدالة 
Drawer Layout.setDrawerListener)‏ والتي يمرر لها كائن من نوع .ActionBarDrawerTIoggle‏ 
الإجراء المراد تنفيذه عن إغلاق أو فتح درج التصفح يتم كتابته في الدالتين ()ع021(125960105 و 
(62600م021021:60 على الترتيب. الكود في الأعلى (من سطر رقم 45 إلى 56) يوضح هذه الخطوة بالرغم 
من أنه لم يتم استخدامها لتنفيذ أي إجراء في هذا التطبيق. 
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أسئلة على الوحدة الخامسة 

ما الفرق بين قائمة السياق (uىعM‏ غء0021)) والقائمة المنبثقة (11مع741 م1ام20)؟ ومتى تستخدم كل منهما؟ 
قم بتعديل تمرين 3-4 والذي يعرض قائمة (/1.15]9/168) تضم أسماء وصور مجموعة من الأصدقاء. عند 
الضغط لفترة على اسم صديق في القائمة یتم عرض قائمة سياق (Context Menu)‏ تضمن زر حذف 
"061616" عند النقر على زر الحذف يتم حذف السطر الخاص بالصديق من القائمة (9/1659آ]115آ). 

قم ببناء التطبيق الموضح بالشكل والذي يستخدم عنصر عرض من نوع 7176517161 كمحتوى رئيسي ثابت 
بالإضافة إلى درج تصفح (إe‏ س54 201ع71391) يضم قائمة بأسماء بعض المواقع الالكترونية الشهيرة 
مثل ع1ممرى ,1ع 0600 ,12065001 وغيرها. درج التصفح يظهر عند السحب من اليسار لليمين» و عند النقر 
على أي منهاء يتم إخفاء درج التصفح ومن ثم فتح الموقع في عنصر العرض 79665/169. 


فت 


E ] Navigation Drawer 


عنوان الكتاب الكلية الجامعية للعلوم التطبيقية 
رقم المقرر 
الوحدة السادسة: 
استدامة البيانات في نظام أندرويد 
(Data Persistence in Android)‏ 
يتعلم الطالب في هذه الوحدة: 


”د الطرق المختلفة لحفظ البيانات الخاصة بتطبيقات أندرويد ومتى يجب استخدام كل منها. 
”7 إنشاء تطبيقات ترتبط بقواعد البيانات. 
> تنفيذ إجراءات مختلفة على قواعد البيانات وعرض النتائج في واجهة المستخدم. 


لدراسة هذه الوحدة لابد من الإلمام بمبادئ التعامل مع قواعد البيانات تعليمات ,501 المختلفة. كذلك لابد من الإلمام 
بأساسيات القراءة والكتابة للملفات بلغة جافا. 


يوفر نظام أندرويد أكثر من طريقة لحفظ البيانات الخاصة بالتطبيقات. أهم هذه الطرق تشمل ما يلي: 
ه التفضيلات المشتركة (وععمءإءع؟٥إ۴‏ 2160 ط5): وتشمل حفظ بيانات أساسية بمفاتيح محددة -رم)) 
.value pairs)‏ 
٠‏ الذاكرة الداخلية (Internal Storage)‏ وفيها یتم تخزين البيانات في الذاكرة الداخلية للجهاز. 


ه الذاكرة الخارجية (External Storage)‏ وفيها يتم تخزين البيانات في ذاكرة خارجية مشتركة بين 
التطبيقات. 


ه قواعد البيانات :(SQLite Databases)‏ وفيها يتم تخزين البيانات في قواعد بيانات خاصة بالتطبيق. 
نخدا أي من هذه الطزاق وت على انليتجات التطبيق سال ما كافك البيانات ارا ظها خاس بالتطبيق آي 
يمكق الوصول الا من اغات أخر عوبر كذلك الاه النطلوية لكذزين البناذاك بيع فيا يلى لصيل كل مين 
هده الطلوك : 
التفضيلات المشتركة (Shared Preferences)‏ 


التفضيلات المشتركة (وع0مع:1ع513602:67) هي مكون يوفر حفظ واسترجاع بيانات أساسية بسيطة. كل 
معلومة يتم حفظها يجب أن تكون على شكل مفتاح وقيمة (72106-ل9ع>1) بحيث يحدد المفتاح (رم)) اسم مميز ليتم 
استعادة القيمة (7106) فيما بعد عن طريقه. يمكن استخدام التفضيلات المشتركة لحفظ بيانات من الأنواع البدائية 
)primitive types)‏ وتشمل: ints, longs, and Strings‏ ,11035 ,eansا00ط.‏ يتم الاحتفاظ بالبيانات المخزنة 
من 3 تطبيق ما في التة لتفضيلات المشتركة حتى بعد إغلاق هذا التطبيق. 


للوصول إلى الكائن الخاص بالتفضيلات المشتركة واستخدامه» يمكن استخدام واحدة من إحدى دالتين: 
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»ه :getSharedPreferences)‏ استخدم هذه الدالة إذا أردت انشاء أكثر من ملف لحفظ البيانات. لإنشاء ملف 
تفضيلات جديد يتم تمرير اسم جديد من خلال الدالة .getSharedPreferences))‏ 


:getPreferences) ®‏ في هذه الحالة يتم استخدام ملف واحد لكل فعالية لحفظ التفضيلات» ولا يتم تمرير أي 
اسم لهذه الدالة. 


ولكتابة بيانات إلى التفضيلات المشتركة يجب القيام بالخطوات التالية: 


1. تنفيذ الدالة 0٤41ء‏ والتي تقوم بإرجاع كائن من نوع SharedPreferences.Edi†0۲‏ والذي يتم من خلاله 
الكتابة. 


2. أضف البيانات عن طريق تنفيذ مهام مثل: .putBoolean)O, putString0, putt)‏ 
د اعا تا عة خف الات اة عن شرن فة الدانة زه اسم 


المثال التالي يوضح كيفية حفظ متغير باسم 72511621631006 من نوع 600163 في التفضيلات المشتركة قبل 
إنهاء الفعالية مباشرة» ثم يتم استرجاع هذه القيمة عند تشغيل الفعالية مرة أخرى: 


AEE EY‏ 25ت 5115 تدده CLASS‏ 115 ل وناك 
BU EE 5555216 E mA 5 EO ERE ES AME UME EE E SEE 7‏ 
private Boolean mSilentMode;‏ 


@GOverride 
protectedvoid onCreate (Bundle state) { 
super.onCreate (state) ; 


// Restore preferences 
SharedPreferences settings = 
EES Rae GE EE E EERGES (ERE S NAME, O 
mSilentMode = 
Se EERE 5 IEEEOS lean ) !! 6ت 6115 5ت اللنده‎ Fal Se), 
setSilent (mSilentMode); // Do something with silent 


} 


@GOverride 
EO 2 كلت ك2 اكت‎ OMS EOP 0 
super.onStop )( ; 


// We need an Editor object to make preference 


changes. 
SharedPreferences settings = 
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SEES RSAC عدت ع سل‎ CEE RECS E REE SAME ODT 
SMa Re EEe f لات 13ت‎ CES HEME 6ه‎ CEENEOE . 52 6 6226-5: CSTE DE 
COME لدت 2290611 1ه : عدت‎ (ES LEME MOSSEL, MOSM Lem EMSS e ) 


1 Commi EME CES 
©6111 EOE. COMME )( : 


. أنظر الدالة () م0250 ولاحظ كيف تم تطبيق الخطوات في الأعلى لحفظ قيمة المتغير 71511651131006 حيث تم 
استخدام المفتاح "51162031006" كمعرف. لاحظ أن ملف التفضيلات محدد باسم 749/21614517116 والذي تم تمريره 
للدالة ()وععمع:ه]ء:6553:602هع. عند تشغيل الفعالية مرة أخرى» يتم استرجاع البيانات من التفضيلات 
المشتركة أثناء تنفيذ الدالة ()ع0201626. لاحظ أنه تم الرجوع إلى نفس الملف والذي اسمه 518[16]ع:2/1(/2. 


ملاحظة: عند تشغيل الفعالية لأول مرة لن يكون هناك بيانات مخزنة خاصة بالفعالية. في هذه الحالة سيأخذ 
المتغيرالقيمة الافتراضية وهي 0156 والتي تم تحديدها في المدخل الثاني للدالة getBoolean("silentMode",‏ 
.false)‏ 


(Internal Storage) الذاكرة الداخلية‎ 


يمكن تخزين البيانات مباشرةً في الذاكرة الداخلية للجهازء وتكون البيانات المخزنة خاصة بالتطبيق الذي تم التخزين 
من خلاله ولا يمكن للتطبيقات الأخرى الوصول لهذه البيانات. عند حذف التطبيق تحذف البيانات المتعلقة به تلقائياً. 


لإنشاء وتخزين ملف في الذاكرة الداخلية يمكن استعمال الخطوات التالية: 


1. نفذ الدالة (11]0م)01116011عم0 ومرر لها اسم الملف المراد انشاؤه وتخزينه ووضع الوصول ع12)10عم07© 
200 . تقوم هذه الدالة بإنشاء الملف وإرجاع كائن من نوع 111601100115163 والذي من خلاله يتم 
الكتابة إلى الملف. 


2. نظراً لأن S٤٥4۳‏ ںم)ں 0ء۴1 يستخدم لكتابة البيانات بالصيغة الأولية و83/1» و حتى تتمكن من كتابة أي 
نصء أنشي كائن من نوع ما Pn W‏ ومرر له الكائن من نوع .FileOutputStream‏ 


3. اكتب إلى الملف باستخدام الدالة (11240م. 


4. أغلق الكائنات من نوع«ررهء:)10065م]1116010 و Print Writer‏ ذلك حتى لا يبقى الملف مفتوحاً بعد الانتهاء 
مه 


هذه الخطوات موضحة في الكود التالي: 
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5 EE E EN ame N لت‎ EN 

SEE SEE NG eNO 57612111 لك‎ 

FileOutputStream fos = 
openFileOutput (fileName, Context. MODE PRIVATE); 
PrintWriter pr = new PrintWriter (fos); 

OE O 102 (SEE E) 

PE. لاك‎ 5526 )| : 

EOS ©0653 O 


لاحظ أن وضع الوصول 1۴ 8_۲۸1۷۸ 105 يعني أن الوصول للملف خاص بالتطبيق الحالي فقط. 
لقراءة ملف سبق تخزينه في الذاكرة الداخلية يمكن اتباع الخطوات التالية: 


1. نفذ الدالة openFileInput()‏ ومرر لها اسم الملف المراد فتحه. هذه الدالة تقوم بإرجاع كائن من نوع 
.FileInputStream‏ 


2. حتى تتمكن من قراءة محتويات الملف سطراً سطراء أنشئ كائن من نوع BufferedReader‏ ومرر له الكائن 
FileInputStream‏ 


3 اقرأ محتويات الملف سطراً سطراً باستخدام الدالة 1601.306 حتى تصل إلى نهاية الملف (عندها ترجع الدالة 
read Line‏ قيمة 111ام). 


4. أغلق الكائنات من نوع BufferedReader‏ و .FileInputStream‏ 
هذه الكو ات مر ضح ارد انى 


SEE AM AM SS OBE EAE N 12 (e ES E ED‏ 6م تدكا 
BufferedReader br = new BufferedReader (new‏ 
InputStreamReader (in));‏ 

SEO 5 2 تع‎ 

while ((strlLine = br.readLine())!= null) { 

KSEE LAME)‏ كلك AME‏ عدم OME.‏ 2210 5 زو 

/ 

1550 2 نط 

CE OSE‏ :مك 


(External Storage) الذاكرة الخارجية‎ 


يدعم نظام أندرويد حفظ الملفات في الذاكرة الخارجية والتي قد تكون ذاكرة يمكن إزالتها وتركيبها 1657012616 
مثل 0:0 55> أو ذاكرة ثابتة لا يمكن إزالتها. الملفات المخزنة في الذاكرة الخارجية يمكن الوصول إليها من أي 
تلفق آخر وذلك كن الملفالة: المخوكة داك لدا راي كرن خاصمة اة 
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قبل القراءة أو الكتابة للذاكرة الخارجية يجب إضافة إذن (10155100هم) في ملف الوثيقة (813214656) الخاص 
بالتطبيق» حيث أن هناك إذن بالقراءة )READ_EXTERNAL_ST†ORAGE)‏ و إذن بالكتابة 
(1171113_231181141_5101:5017) كما هو موضح بالأسفل: 


mami 296955 > 

<uses-permission 
android:name="android.permission.WRITE_EXTERNAL STORAGE"/> 
android:name="android.permission. READ EXTERNAL STORAGE"/> 


<Jmanifesl > 


ملاحظة: ابتداء من 4.4 لAndroi‏ لا تحتاج لإذن permission‏ إذا أردت كتابة أو قراءة ملفات خاصة بالتطبيق 
فقط, 


كما يجب قبل محاولة الوصول للذاكرة الخارجية التأكد من أن الذاكرة متوفرة عن طريق تنفيذ الدالة 
()6121510128651216م. الذاكرة الخارجية قد تكون في حالة "مركبة" 2210660 "مفقودة" ع1015510 
,"القراءة فقط" 0213 76320 بالإضافة لحالات أخرى.المثال التالي يوضح دالتين لفحص حالة الذاكرة الخارجية: 
الأولى تفحص إذا كانت الذاكرة متوفرة للكتابة والقراءة بينما تفحص الثانية إذا كانت الذاكرة متوفرة للقراءة فقط. 


1< 616505 iE external 660252662 25 Ava lale EOE 2 AMA 
WEEE 2/4 
public boolean isExternalStorageWritable )( { 

56122110 5 6215225 11 17 11 901111211 1 .SELExXteEENaAlSEOEaJeES lale () 7 

if (Envir oemmenm ع‎ MEDINA MOUNRED equa LS )8 55 رت‎ ! 

EOE UE EE UO F 
} 
return false; 


} 


4 0355 ME CEE EMAN SEO MS Aull BleE EO GCE leEASE Ee 
/ 
public boolean isExternalStorageReadable )( { 
SEAM O جات عا دك‎ ZERVITKORMEME. ع كن‎ 22 EEKMRALSEOESIE SES EE )( : 
if ) كا‎ 11 112 onmene MEDIZ MOUNTED : وت‎ SKS Ea Ee) ||| 
الل[ با انا . اطع دهع 1 تتطط‎ MOUNTED READ ONLY.equals (state) ( 1 
16 1211 CLUE, 
/ 


return false; 
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المثال التالي يوضح كيفية تخزين ‏ ملف في الذاكرة الخارجية. الدالة 
Environment.getExternalStorageDirectory Û‏ تقوم بإرجاع مسار المجلد الذي يمثل الذاكرة الخارجية 
حيث يمكن حفظ الملفات. 


File directory = Environment.getExternalStorageDirectory () م‎ 
E EAE mew Eile ) 6ه 2262 للك‎ 07, EEE EMAL EN E E "( 
E CE EES SES 
file.createNewFile(); 
FileOutputStream fos = new FileOutputStream (file); 
OM EPUES EEE AMEN EERE OSE MeV 101 ل 11ت 126 عا د عا لكر ع‎ ECE (EOS) 
PrintWriter pr = new PrintWriter (osr); 
BE WE Ee (J, 
OSE. 1560 
TOS. CLIOSE (JF 


7 


تمرين عملي (6-1) 


يهدف هذا التمرين إلى التدرب على حفظ بيانات تطبيق ما باستخدام الطرق الموضحة مسبقاً وهي التفضيلات 
المشتركة (وعع0ع17ء1ء16021وط5)» الذاكرة الداخلية (عع516012 ]إIntenra(‏ والذاكرة الخارجية (External‏ 
(ع560138. واجهة التطبيق موضحة في شكل 6-1؛ وتتكون من مربع إدخال (101616©726) يتم من خلاله إدخال 
نص ليتم حفظه و استرجاعه بالطرق المختلفة (حفظ في الذاكرة الداخليةء استرجاع من الذاكرة الداخلية» حفظ في 
الذاكرة الخارجية» استرجاع من الذاكرة الخارجية). لنتأكد من حفظ البيانات واسترجاعها بشكل سليم» نقوم بحفظ 
البيانات وإغلاق التطبيق ثم تشغيله مرة أخرى واسترجاع البيانات بنفس الطريقة التي حفظت بهاء ونكرر هذه 
التجربة لكل طريقة 


تحتوي واجهة التطبيق أيضاً على زري انتقاء (22010810]05]) لتحديد لون الخلفية (70100ع6301)؛ حيث أن 
اختيار أي لون يؤدي إلى تغيير لون الخلفية. سنقوم باستخدام المفضلات المشتركة (SharedPreferences)‏ لحفظ 
اللون واسترجاعه عند إعادة تشغيل البرنامج وذلك باستخدام الدالتين ()ع15ه002 و 0ع« uءe‏ ۸ه على التوالي. 
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شكل 6-1: واجهة التطبيق الخاص بتمرين 6-1 


<RelativeLayout 
SIRS 2 EOS US 105 O : // SOMES AME EOLA COM EOS Sh 


MIMS AMAC NEA UME EP 2 /1SCMEMAS  ARGSESNG ل 1ت‎ AEE S7 ANOBO EAL 
android:id="@+id/container" 
AMA EOE E LE MOE GE MS ma Ee Rae E 
1ك‎ 01 02114: la VOU E Men ORM E> IMAC ae Ell 
android:paddingBottom="@dimen/activity_ vertical margin" 
android:paddingLeft="@dimen/activity_ horizontal _ margin" 


android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
EOS LS COME عدت‎ 5 SL MARAE EYE > 


ECL ا‎ E 
android:id="@rid/editText!" 
AREOLA ODE MEE SEAS) COREE E 
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NS MOE Me ES ES IEA لت ع مت‎ 
la WOE _ ALI OREAEOR CTO HE EUS 

COME EOE AOE a LS E E‏ 61ت 1ل 
Magi RIO 2 OO‏ 511511761015 


: avo wi م عا اك‎ COM Ee ll 

EMO eS SHEA COME CM E 
layout_alignLeft="@+id/saveInBtn" 
layout_ below="@+id/saveInBtn" 


:ems="10" > 


عنوان الكتاب 


رقم المقرر 


211016 
201611 S LOL 
201611 1 


android 
MEE © 1 Cl 


<requestFocus /> 


1 للاكان‎ 4 FIC LOE U IIS EI 


"OME MEK OAS IREE ER A 


> 


COME CR E‏ 21527722 _ 51ت ال 

ME MOE Me SESE عت 6 عت ماد‎ 
layout_alignLeft="@+id/loadInBtn" 
layout_below="@+id/loadInBtn™ 

: ONCLICK SAVE BEKXEC ENA 
:text="Save External 


sz 


NA MOE GE E EA OE OIE E E 

Me E MESH IEA COME CE‏ 6112 ا 
layout_alignLeft="@+id/saveExBtn"‏ 
:layout_below="@+id/saveExBtn™‏ 
OAC AE K=# OAC EE ERAN‏ 
:text="Load External‏ 


> 


SMO ME ERS WEA COME EN E 

5 1357610165 _ 6110572 CE ORIEN E 
layout below="@rid/editText" 
SMO CEN EERO 2 O ع‎ A N E UE 
LAWO MEE CAR TOS 1 SE 
:onClick="saveInternal" 
EE ESL 8350 EMEC ER A 


> 


زايا 


u 


رايا 


رايا 


:text="Load Internal 


:id="@+id/saveExBtn" 


1d="@G+id/loadExBtn" 


ta EC TG 4S ae HIMBER 
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> EAM 16 ع‎ 
1ه‎ E EO 


51611 ¢ 


android 


201001526283 
200 
10ت‎ 621 CIE 


20221 

android 
8 11 رت ع‎ 

52120256 


android: 
2221 + 
2-1 
android: 


android 
android 
SEUE E OM 


:غ2 
+ 22210 
android:‏ 
android:‏ 


222512 

android 

android 
ع ا لك‎ OM 


22121 
AEE 1 


android 


202000 
611 11ت 
201016 


android 
android 
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<TextView 
ERMOEOLGAS LO OFFIC EVEGCOLOE 
AME EOE E E OE GE MS ES COM ECM E 
:17ت مرك للك‎ 1125915 MENG MES ESS الست فت‎ 
3202010 : 133701163119281 016- " 4 +1 0/ 220106 20112" 
3202010 : layout_below="@+id/loadExBtn" 
14ت تك لت‎ 112175116 Ma ESMERE 24 All 
6ت ع :61 1ه مراك لات‎ 1 2 35126 165016 1 F 2 
android:textSize="20Spl /> 
<RadioGroup 
android:id="@+id/radioGroup™ 
18ت 21 :16ت 1ك لت‎ EG ES ES COM EEN E 
رلك‎ GEO EG E EA OIE E EG ES ESS COM ECEME 
android: layout_below="@+id/tvBgColor" 
AMEE هك‎ 1 4 EEE MOE COME OE OAS 1ت‎ E EE 
152 5ه كك‎ 0 EEO 
android:id="@+id/rdRed" 
ARE ROG SAO E EGE MS EA COM EEN E 
14ت عذك رلك‎ Sa OU E Me OMS ESS COM ECEME 
AMEE 2 141 SA VOU E MS ESERO OA 
android:text="Red" /> 
1215 dM 12م‎ 0 EEO 
android:id="@+tid/rdGreen" 
ABE EOE SAMO E EG E MS HS COM EER E 
AEE OG A OME Me SES ESS COM ECEME 
android:layout_alignLeft="@+id/rdRed" 
android:layout_below="@+id/rdRed" 
AMEE ال 18م ادهو‎ 856135 MS ESM 1 لكوم‎ SE 
3202010: text="Green" /> 
</RadioGroup> 
</RelativeLayout> 


تذكر أننا سنحتاج إلى تغيير لون الخلفية أثناء عمل التطبيق» مما يستلزم الوصول للهيكلية ()0ره1) برمجياً لتغيير 
لونها بناءً على اختيار المستخدم من قائمة الألوان. للوصول للهيكلية (اامره1)» يجب أن يكون لها رقم 
معرف (11) في ملف 12 حتى نتمكن من تنفيذ الدالة (6005/16183/100. لذلك تم إضافة الخاصية 
+id/container"‏ © "-30010:10 لملف التصميم حتى يتم إنشاء معرف 1] لها. 

تذكر أيضاً أنه للوصول للذاكرة الخارجية وحفظ البيانات يجب إضافة الإذن 
WRITE_EXTERNAL_STORAGE‏ للقيام بذلك. 
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الكود التالي يوضح الفعالية (/0131/611516) الخاصة بالتطبيق. 


AE EN E‏ 5 لطت كدت ع لدب ل عات شك 13 CESS‏ كك 11د لل لكر 


BEME تدعت الت كم 14ت 2ت‎ MO EEE SOS - TYPE SF 
مهن 85812 314ل ولتت‎ 156651-77 


EditText editText; 
@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
5 16 تلت‎ : OnNCEEa Ee (Save IRNSEAREEeS Ea Ee ) 
SEE COMIE ER EVE E TEMO ACE Ey MA ER) 
editText = (EditText) 
ES E NOLAN E WE VLC (ERE EAN ERE EE 
RadioGroup rdGroup = (RadioGroup) 
EMIS. ك1 رز كيك ا اك 15 1 ع‎ ) 15 : 10: 12301 OCF OUP); 
rdGroup.setOnCheckedChangeListener (new 
OnCheckedChangeListener () { 


GODS )]:‏ حن لير GCG TSS‏ ©) د 


60 TS OE GOR ةج كم‎ 52 0 e OS 


@GOverride 
public void onCheckedChanged (RadioGroup 
group, int checkedId) { 
RadioButton selected = (RadioButton) 
E تاك 1د ات جلت‎ LS ) ك كلت‎ e KESE) 
bgColor = 
selected.getText ().toString )( م‎ 
56 2 85 2 عدت 16214 6 12 19ت‎ (ESCO LOE ) 


| شم كم كم هخم هخم كخم هخم هم كم N N N‏ 
ين اق ر يم 


N 
دن‎ 


OOO لك دن كن) ذا 5 إذن)‎ <3 3 <3 DNS O 
25 2 حن آنا ذه ال 025 كا كت دک دک ل حنم الك كك‎ 


/ 
jg 
/ 


public void savelInternal (View view) { 
LEW 11 
1ك ع لمات اناس‎ SERE AM EOS > 
EM SOE E EO كر‎ 016 (ME A ات لل‎ ESE, 
COME عدت‎ : MODE EET VATE) 


PrintWriter pr = new PrintWriter (fos); 
BE WEEE ) 2611222226 IEEE SE CEOS E EME ODE 
OE. 5-6 (J 


OS ©1555 )( : 
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(" !) عاكدكظ كاوه . CGI REE‏ 5 
OM EC‏ ع (BILNE EOUNGOEEEEP‏ كلت 622 [ :40 
E‏ 266 ات 8562 11 عدم 6 4 
ذ كت تند (LOSER‏ كلت 62 62 [ :42 
(E‏ 6ت 12 ACHR‏ 6 5 عا CBE‏ :43 
} : 44 
| :45 
:46 
public void loadInternal (View view) {‏ :471 
EW 1‏ :48 
LE IEEE SEE EAM EMS >‏ :49 
(UMVELLE. EEN) 2‏ 0115 كت لاست لاس سك كرت S0 EA1LS.‏ 
BufferedReader br = new BufferedReader (new‏ 51 
: ( 251 2) 122105524 6 5 6 1] ك1 :52 
لك SEEING CCU,‏ 5 
while ( (tmp=br.readLine()) != null) {‏ :54 
ESSE | EMO,‏ : 55 
} :56 
SE DE. CLOSE )( :‏ 
iS CLOSE )(‏ 5 
E CO EEE E SEE CSE EE E‏ 
1 )€ كدت 1 ع كرتت 5ت 6 والت 1ك 5 ) كلت 621 J‏ 50 
ACE )( :‏ تداك 2 ع CE PETES‏ 61 
كت OM‏ 1 م ت152::3ك1) لت 622 [ 60 
EAC KRE CE )| :‏ 65 1ه عدم CE‏ 539 
} :64 
J}‏ 655 
:66 
public void saveExternal (View view) {‏ :67 
EE 7‏ :66 
Le )( ( !‏ هات ع 1 ع ارات 20 OE‏ عا 5 11ت جز عل ك كا كد ك5 11 ) 112 9 
OE ENE AMEE EOE VY >‏ 
Environment.getExternalStorageDirectory ();‏ :71 
2-2 كك ) EE E E Ee SS me E le‏ 28 
Eterm aAl ELLE. TXT)‏ 738 
E E E ESS SES O‏ :74 
file.createNewFile();‏ 5 
FileOutputStream fos = new‏ 16 
( 2 1 ندع ) AM‏ 2 ع 5 6 لاركر 11906 دان :ا 
OSE -‏ عدت 62 1ط لكتت 2ت 6 51 66 7 
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OutputStreamWriter (fos) ; 


PrintWriter pr = new PrintWriter (osr) م‎ 


pr.write (editText.getText ().toString()); 


DE. للكت‎ 556 )( 
052.556 
10581588 )( 
CL 011325 1 56 كع‎ (WW) م‎ 


(TOEXTEPELOR لت‎ | 


عنوان الكتاب 


رقم المقرر 


} 
جك 5 5 [ 


e.printStackTrace )( م‎ 


د (Mie‏ 1ت عدت 12ت 2 1105 ملو 125 لل وناك 


} 


Ey 1 


11 (isExternalStorageReadable () ) { 
RAE EERE ECORV 


7 () 7 618211226612 601230 1121-5 © 2 4 ا عا 06 ١‏ 2 011101211 2 د نا 1 لكل 


" 2166© 2 11211ت2‎ 2: EXE), 


ENE تللم‎ E mew Ei le (OL ECC E SEY, 
iL{ECIlE. e< 
FileInputStream fis = new 


FileInputStream(file); 
InputStreamReader isr = new 
InputStreamReader (fis); 

BufferedReader br = new 
BufferedReader (isr); 
SEMO ESE, EMO, 
while ( (tmp=br.readLine () ) 


EE SEMO, 


} 


BE. الت‎ 556 )| 
editText.setText (txt) م‎ 


(IOException e) { 


} 


AUN اك‎ f 


} 
} Cale 


e.printStackTrace )( م‎ 
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FF‏ 1198 
OE‏ 
COvei e1el®‏ 1218 
protected void onResume () {‏ :122 
مم () super.onResume‏ 2 
SharedPreferences sp =‏ :124 
this.getSharedPreferences (PREFS,‏ :125 
COM Ee MODE EE VATE)‏ 12655 
لك 1566260107 ) ERE‏ ع 5 12ت 5 7 ECOL <S SO‏ 12 
mU)‏ - ! كدت 5952651) iE‏ 1288 


(عدت1ت-2 0 159) عدت الات 4ك جلن 5 16 10ت 2 8ع 5 ERN 5 ١‏ 
} 


@GOverride 
عكر‎ ©2266 VONO 522056 )( | 
super.onPause )( م‎ 
E KBSCOLOG > لاس‎ | 
SharedPreferences sp = 
this.getSharedPreferences (PREFS, 
SSE SSE ODE ER ل‎ 
HOE كه‎ CONES <> SOS COE O 


5 دن لن/) لن) (ن) تن) ذ)) ذن) OU O‏ كلا 
OD BOG‏ حكن رن GIS‏ كا © 


OO IS SS ONE هذا تك‎ | 


61116 مدعا 6016 : عدت‎ ANOS KESEN, 5608421 
4 GE ESE. COMME )( 
4 } 
14 } 
14 
14 6ت 566 2ه عكر‎ UOMO 5 2122 129 12 عدت 11ت 02ت‎ (SEEING COCOLSE | 
14 RelativeLayout bgElement = (RelativeLayout) 
14 تيك 1 بلك ل‎ VIS R. TEI COME AIMEE) 
14 E )15 046011 كت : 6دت‎ 022125 (LEE LN) 
11 bgElement.setBackgroundColor (Color.RED); 
150 8 ع صرت '') 12115كت : 012 61 1596) علد 545 للك‎ LL) ) 
SE bgElement.setBackgroundColor (Color. GREEN) م‎ 
1528 J 
9 
154: } 


يحتوي الكود على أربعة دوال رئيسية كل منها مسؤول عن تنفيذ إجراء محدد» وهي كما يلي: 
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ه الدالة savelnternal)‏ (أنظر الكود من سطر رقم 0 إلى 45): وفيها يتم قراءة النص من العنصر 
Edit ٣×)‏ وحفظه في الذاكرة الداخلية في ملف اسمه ]103/1116.)2. 


e‏ الدالة loadInterna1()‏ (أنظر الكود من سطر رقم 47 إلى 65): وفيها يتم قراءة الملف ».انرص والذي تم 
حفظه مسبقاً في الذاكرة الداخلية» ومن ثم عرض محتويات الملف في العنصر )6 1501]1. 


« الدالة ۸210إء)×8 مهو (أنظر الكود من سطر رقم 67 إلى 91): ويتم تنفيذها عند النقر على زر " 525/6 
61031" ليتم حفظ النص المكتوب في العنصر 1:0116:6 إلى الملف ]70916.62 والذي يتم تخزينه في 
الذاكرة الخارجية. لاحظ أنه يتم فحص حالة الذاكرة الخارجية للتأكد من إمكانية الكتابة إليها قبل عملية الحفظ 
عن طريق تنفيذ الدالة )(b1eۆWrita .isExternalStorage‏ 


ه الدالة (10201]60210:(أنظر الكود من سطر رقم 93 إلى 119) ويتم تنفيذها عند النقر على زر " 1020 
6121" ليتم استرجاع محتوى الملف .1231116 وعرضه في العنصر ]2 201]1. لاحظ أنه يتم فحص 
حالة الذاكرة الخارجية للتأكد من إمكانية القراءة منها قبل عملية الحفظ عن طريق تنفيذ الدالة 
.isExternalStorageReadable)‏ 


في الدالة )ع2٥٣۸٥‏ تم إنشاء مستمع من نوع OnCheckedChangeListener‏ للاستماع لحدث النقر على 
أحد أزرار الانتقاء (00غ1220108104)» حيث يتم بناءًَ على ذلك تغيير لون الخلفية عن طريق تنفيذ الدالة 
BackgroundColor)‏ tءء‏ (أنظر الكود من سطر رقم 145 إلى 152)» وكذلك حفظ لون الخلفية الحالي في 
المتغير إه[ه عط (أنظر الكود من سطر رقم 8 إلى 28). 

تم أيضاً تطبيق الدالتين ()eیں ٠۸۴‏ (من سطر رقم 133 إلى 143) و 0ع, ںو۸٠‏ (من سطر رقم 122 إلى 
0) وذلك حتى يتم حفظ واسترجاع لون الخلفية الحالي تلقائيا عند إغلاق التطبيق وإعادة تشغيله» حيث يتم 
استخداع التفضيلات المشتركة وععممع1ءع1ع5531021 لهذا الغرض. 


(SQLite Databases) قواعد البيانات‎ 


5011 هي مكتبة برمجية مفتوحة المصدر (عع50101 «عم0) تستخدم محرك قواعد بيانات (Database‏ 
(ءمناع م8 يدعم قواعد البيانات العلاقية (102]2862565 1612]10021) وما يتعلق بها من خصائص مثل ,501» 
والتعاملات (15325261005) و التصريحات المعدة مسبقا .(Prepared statements)‏ 


يدعم 501.16 ثلاثة أنواع من البيانات هي النص 1٤×1‏ وهو يقابل عمذع)؟ في لغة الجافاء +17171190131 وهو 
يشابة ع2م1 أو 106 في الجافاء و ,1141 وهو يقابل 00616 في الجافا. أي أنواع أخرى من البيانات يجب 
تحويلها إلى أحد هذه الأنواع الثلاثة حتى يمكن تخزينها في قاعدة البيانات. كما أن ]5011 لا يتحقق من نوعية 
البيانات قبل تخزينهاء بمعنى أنه يمكن تخزين بيانات رقمية في عمود يقبل بيانات نصية والعكس صحيح. 

مكتبة 5011 مضمنة في كل جهاز يعمل بنظام أندرويد» وبذلك لا يحتاج إلى إي إعدادات أو تحميل ملفات 
لتشغيله. قاعدة البيانات الخاصة بأي تطبيق يتم تخزينها في المسار: 


DATA/data/APP_NAME/databases/DATABASE_NAME 
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حيث 5۸1۸ في المسار السابق ترمز إلى المسار الذي ترجعه الدالة .Environment.getData Directory)‏ 
5 _ططم في المسار السابق يرمز إلى اسم التطبيق» PAA BASE_NAME‏ یرمز إلى اسم قاعدة 
البيانات. 


الرزمة مع 2ء1ء2م ع320010.1386256 تحتوي على كل الفئات (125565ح) اللازمة للتعامل مع قواعد البيانات» 
بينما الرزمة عع128ء3م 320010.12630256.50116 تحتوي على الفئات (0135565) الخاصة بالتعامل مع 
.SQLite‏ 

إنشاء قواعد البيانات 

لإنشاء قاعدة بيانات جديدة لتطبيق أندرويد ما يجب إنشاء فئة جديد (01355) متفرعة من الفئة 


:11 كما هوموضح في المثال التالي حيث تم إنشاء الفئة :6©1م217:5001.1611»1 المتفرعة من 
:SQLiteOpenHelper‏ 


public class MySQLiteHelper extends SQLiteOpenHelper { 


BUC ITE MyYSO EEE عله‎ (CON ECXE COMEEX E, SEEDO Mame, 
IME ve SA OM) [ 
SUPper (CONnEexXE, Mame, MUll, vVerSIOM); 


} 


@GOverride 
public void onCreate (SQLiteDatabase db) |] 
db.execSQL ("create table student (id integer 
primary key autoincrement not null, name text not null, age 
integer);"); 


} 


@GOverride 
public void onUpgrade (SQLiteDatabase db, int 
oldVersion, int newVersion) { 
db.execSQL ("drop table student") م‎ 
ERN 5 : جه‎ 21262256 (OB 


لاحظ أنه من الباني (01]ع1مؤوم0"0©) يتم استدعاء الباني (+1م]ع660ومه0©) الخاص بالفئة الأم 
121 حيث يمرر لها ثلاث متغيرات أساسية وهي: 
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ه المتغير ا×ع)مرهء يشير إلى مكون التطبيق إلذي يستخدم قاعدة البيانات مثل مؤشر لكائن الفعالية 
المضيفة (2)0]17167) أو الكائن الذي يمكن الحصول عليه من الدالة ©]):ع]116261020002ممشاءع. 


ه المتغير مهم يشير إلى اسم قاعدة البيانات المراد إنشاؤها أو تعديلها. 


ه المتغير 7615105 يشير إلى رقم إصدار قاعدة البيانات»وهو رقم يبدأ من 1»ويجب زيادته في كل مرة يحدث 
فيها تغيير في هيكلية قاعدة البيانات. 


في الفئة الجديدة (01255) :1م1ء11ع18175011) يجب إعادة كتابة الدوال التالية: 


:onCreate) ®‏ ويتم استدعاؤها تلقائياً من النظام رلا تنفذ من التطبيق) عند إنشاء قاعدة البيانات لأول مرة. في 
الكود الموضح في الأعلى يتم إنشاء جدول باسم رمل ناء مكون ثلاثة أعمدة وهي 266 ,12126 ,10. 


:onUpgrade() e‏ ويتم استدعاؤها تلقائياً اذا تغير رقم الإصدار veri‏ وذلك في حالة تغيير هيكلية قاعدة 


على سبيل المثال» عند إنشاء قاعدة البيانات لأول مرة يتم تنفيذ الدالة ()عاه٠ ٠۸0‏ والتي يتم فيها إنشاء الجداول 
والربط بينها. عند حدوث أي تغيير في قاعدة البيانات مثل تعديل جدول ما »يجب زيادة رقم الإصدار عند إنشاء 
كائن من نوع مم .MySQ te11‏ يقوم 501116 تلقائيا بمقارنة هذا الرقم مع رقم آخر اصدار مسبق لقاعدة 
البيانات» وإذا كان مختلفاً يقوم بتنفيذ الدالة onUpgrade()‏ حيث یتم فيها إجراء التعديل اللازمة على هيكلية قاعدة 
البيانات. في المثال السابق تقوم الدالة onUpgrade()‏ بحذف الجدول وإنشائه مرةً أخرى. 


الوصول والتعامل مع قواعد البيانات 


الفئة per‏ 5011606111 توفر دالتين تمكن الوصول لقاعدة البيانات هما: getReadableDatabase()‏ و 
)eDatabaseاetWriteabع‏ حيث تسمح الأولى بالقراءة فقط بينما توفر الثانية إمكانية القراءة والكتابة من قاعدة 
البيانات. كلتا الدالتين ترجعان مؤشر إلى الكائن 501146102686256 وهي المكون الأساسي الذي يتم من خلاله يتم 
تنفيذ أي تعليمات ,50[1. 


يوفر عasطSQiteData‏ الدوال ()ع]ع1ء0 update),‏ ,(110ء125 وذلك للإضافة والحذف والتعديل على محتوى 
قواعد البيانات. على سبيل المثال؛ الكود التالي يوضح كيفية اضافة بيانات إلى الجدول 501066 الذي تم إنشاؤه 
مسبقاً. يتم تجهيز البيانات المراد إضافتها ككائن من نوع 00216249731065 وفيه يتم إدخال البيانات على شكل 
مفتاح-قيمة (7216-(9ع>1)» حيث يحدد المفتاح (رم)) اسم العمود في الجدول بينما القيمة (7211) تمثل محتوى 
السجل في العمود. الكائن 2046265/211165) يمكن استخدامه لإضافة أو تعديل البيانات في الجدول. 


// Create or access a database with the name "studentdb" 
MySQLiteHelper sqlHelper = new 

MySQLiteHelper (getApplicationContext )( , "studentdb",1)7; 
SQLiteDatabase db = sqlHelper.getWritableDatabase )( : 
ContentValues values = new ContentValues )( م‎ 

values.put ("name", name); 

values.put ("age", age); 
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ABD. 125 ا ض حك 0ك "!) 2 كك‎ !, MUI, VOIS); 
CB. CLOSE )( : 
sqlHelper.close(); 


تنفيد الإستعلامات (Queries)‏ 
تنفيذ الاستعلامات يتم باستخدام إحدى دالتين من الكائن ©1(263525ع]5)001.1. هاتين الدالتين هما: 
ه الدالة rawQueryÛ‏ وهذه الدالة يمرر إليها الإستعلام والقيم المستعلم عنها كما في المثال التالي: 


Cursor Cursor = database. query ("SELECT * from student where 
mame > 2 AMO دوك‎ - 2 23107 SEENON LAME "20 


حيث ع03]225 هو كائن من نوع .SQLite Database‏ 


التالية: 


PUC INE CIESOE عد كت‎ 7 CSIRO EACLE, مسد فرعت‎ ll COLUMNS, SEAMS 
Sel eCETOR, عدت‎ 1520 ll 3221 3 اتات‎ ONAEIS, SEEING SEOUEEV, 5 61 
MEE SEE رمه‎ 0126161213157 SEEDO AMEE 


حيث تفاصيل هذه المتغيرات موضحة بجدول 6-1 التالي: 
جدول 6-1: تفاصيل المتغيرات المدخلة للدالة )0( SQLiteDatabase.query‏ 


اسم المتغير وصف المتغير 

Table‏ اسم الجدول الذي ينفذ عليه الاستعلام 

Columns‏ اسماء الأعمدة المطلوب إرجاع قيمها. في حال الاستعلام عن كل الأعمدة تعطى 
القيمة 111111 

Selection‏ هذا الجزء يمثل جملة 71/211113 والتي تحدد طريقة تصفية البيانات المستعلم 
عنها. 

selectionArgs‏ هذا الجزء يعطي قيم لأي علامات استفهام 7 قد تكون ضمن المتغير السابق 
Selection‏ 

5001, تكافئ رط م1011ع في استعلام‎ groupBy 

SQا تكافئ ع 12510 في استعلام‎ Having 

5001 في استعلام‎ order by کف‎ orderBy 

Limit‏ قيمته تحدد عدد النتائج التي يتم إرجاعها. 


مثال لاستخدام الدالة ()رإمںي للاستعلام عن بيانات من الجدول ٤٣ع‏ ل ناء موضح بالأسفل: 


SEMO وت للد‎ Om sS . CAMA, mame SOC 
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612522 11ت 1ت 5 2212210252 502 تلات‎ (LS EUGENE, 1ت‎ 1 
WHERE name =2 ald 306 >2, new Stringl | {Anmedl, "20", 
E 117 لض‎ 11 mame, MODE 


حيث ع2 طهاهل هو كائن من نوع ع2 طه)ة 2ء »SQit)‏ وهذا الاستعلام يكافئ استعلاء 9Q1‏ التالي: 


SELECT id,name, age FROM student WHERE name="Ahmed" and 
age>20 order by name 


كلا الدالتين السابقتين ()/725800101615 و ()(0116139 ترجعان كائن من نوع 0001501 وهو مؤشر يؤشر على جدول 
النتائج الناتج عن تنفيذ الاستعلام. يمكن قراءة البيانات عن طريق تحريك المؤشر من سطر لآخر وقراءة النتائج من 


() 1112-56 ظتكت 10 : 1112-5616© 


)١ ١ !‏ 22:56 عدج ع شك Kl CUE SOE i‏ ات لل طم 
CUES COE IME ) 0‏ امد E‏ 
SENOS mame > CURSOR GEES EEE OS‏ 
int age = cursor.getInt (2);‏ 


cursor.moveToNext )( م‎ 


} 


: () 455 1ك 2 زه CUES‏ 


الدالة ()]1201:101115 تنقل المؤشر لأول سطر في النتائج. الدالة ()]71076100116 تحرك المؤشر خطوةً للأمام 
بعد قراءة السطر. الدالة isAfterLast)‏ تفحص انتهاء عملية القراءة وهو ما يتحقق عند وصول المؤشر 11501© 
لما بعد السطر الأخير. 


يتم قراءة قيم الأعمدة لكل سطر باستخدام الدوال ()]0])ءع أو ()ع532]مع وغيرها من دوال قراءة القيم» وهذه 
الدوال تأخذ رقم العمود المراد قراءته كمدخل. من المهم بعد الانتهاء من قراءة النتائج إغلاق المؤشر 1501ح عن 
طريق الدالة ()ع5و10ك0. 

الإنشاء المسبق لقواعد البيانات 


في كثير من الأحيان» يفضل إنشاء قاعدة البيانات في مرحلة تصميم التطبيق بدلا من إنشاءها أثناء وقت التنفيذ كما 
هو الحال عند استخدام الكائن من نوع .SQLiteOpen Helper‏ لإنشاء قواعد بيانات من نوع ع5011]6» يمكن 
استخدام بعض الأدوات المجانية التي تدعم ذلك مثل 8101:561 173688856 501116 (أنظر شكل 6-2) والمتوفر 
مجاناً من خلال الرابط .sourceforge.net/projects/sqlitebrowser/‏ 
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Qet 3 2‏ © 
File Edit View Help‏ 
ER EE EEE‏ 
Database Structure | Browse Data | Execute SQL |‏ | 
e: ES (Rennes) Geete Red‏ 


id name aqe 
1 1| Ahmed | 23 
2 2 Ali 24 


1-2 Go to: 0 


شكل 6-2: واجهة الأداة البرمجية (إمsس‏ 0ا8 172421256 مSQit)‏ المستخدمة في إنشاء قواعد البيانات 


قاعدة البيانات المنشأة يتم حفظها كملف. لربط ملف قاعدة البيانات بتطبيق اللأندرويد» يجب وضع الملف في مجلد 
5 » ثم يجب كتابة الكود التالي في الدالة ()ع]0200162 عن بداية تشغيل الفعالية حتى يتم نسخ الملف إلى 
الجهاق, المثال الثاني يوضع الكود اللازع لنسخ ملف قاعدة البيانات 60881 إلى الجهاز ومن ثم إنشاء كاتن من شورع 
.SQLiteDatabase‏ 


protected void onCreate (Bundle savedInstanceState) { 


String destPath = "/data/data/" + getPackageName () + 
"/databases"; 
EY 1 
File f = new File(destPath); 
1E (lFEOXISES (J) 1 
f.mKQIES () م‎ 
f.createNewFile(); 


---/ /نسخ ملف قاعدة البيانات من مجلد 61+85 35 إلى الجهاز--- 


CopyDB (getBaseContext )( .getAssets )( .open ("stddb"), 


mew لاه 7 1ك‎ 6 5 215 5211 (AES EEE 1 VSESID 
/ 
[ 6-2 12ت‎ KEM LENSE EOUNGES CESS كت‎ 
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م () e.printStackTrace‏ 
كت تك ت155:3ة1) كلت 62102 [ 
Ce )(‏ مكلت 2 6 ES‏ 10 ترم © 


} 


SQLiteDatabase database = 
SQLiteDatabase.openDatabase (destPath + "/stddb", null, 
SQLiteDatabase. OPEN READWRITE); 


/ 
AM‏ دع 5 OUEPUE‏ 2117 22 ع 5 616 21 EEeAM‏ د ع /] كر اس ) COPVDE‏ اده ك الل وناك 
EEeaM) 121905 12662162011 7‏ 5 0151© 

//---copy 1K bytes at a time--- 

Eel ll CU FES > Mew 1512 OZAN 

iE MEG E 

while ((length = inputStream.read (buffer)) > 0) { 


OU EPUES EEE AM. WE Ee (BDU 2 ,عت‎ U, ENO ED : 
/ 


EBES E eam CLOSE )( 
6115 اه‎ 5 E Seam CE OSE )( 


تمرين عملي (6-2) 


في هذا التمرين سنقوم ببناء تطبيق أندرويد متكامل للربط مع قاعدة بيانات وتنفيذ إجراءات مختلفة عليها مثل تنفيذ 
الاستعلامات والإضافة والخذف. قاعدة البيانات باسم 5010612101 وتحتوي جدول واحد باسم 500061 يتكون من 
ثلاثة أعمدة عع ,مصهدرل1. الواجهة الرئيسية للتطبيق موضحة في شكل 6-3 وتحتوي على ثلاثة أزرار: 
A11"‏ 771617" لعرض كل أسماء الطلاب من قاعدة البيانات» "105616" لإضافة بيانات طالب جديدء و "م6]ه1ء(1" 
لحنت طالب من قاهدة الائات 

عرض أسماء الطلاب يتم من خلال قائمة (15]1/1617.]) في فعالية (811710) منفصلة. إضافة بيانات طالب جديد 
يتم من خلال نموذج إدخال يظهر عند النقر على زر "105616" حيث يطلب من المستخدم إدخال اسم الطالب وعمره 
ومن ثم النقر على زر "105616" للحفظ. حذف البيانات يتم عن طريقة عرض قائمة الطلاب في (سع۷¡1ء¡) 
حيث أن النقر على أي سطر في القائمة يظهر قائمة جانبية فيها أمر الحذف "ع]ع1ء(1" » وعند النقر عليه يتم إزالة 
بيانات الطالب من القائمة (115]7/161) ومن قاعدة البيانات. 
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MainActivity 


Student Database 


View All 


ViewActivity InsertActivity DeleteActivity 


Ahmed Tawfiq Insert Student Ahmed Tawfiq 
Atef Ahmed Name Ammar Ali Ammar Ali 

Age 20 
Hani Hassan Hani Hassan 
Ibrahem Saleem Ok Ibrahem Saleem 
Ismael Awad Delete 
Kamel Subhi 


Kamel Subhi 


Mohammed Ali Mohammed Ali 


Omar Salem Omar Salem 


لا|أناأددعععناة لعأمع 5م مع ذا 


Rami Mohammed Rami Mohammed 


شكل 6-3: واجهات التطبيق الخاص بتمرين 6-2. 
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قبل الحديث عن تصميم الواجهات والكود الخاص بالفعاليات» سنعرض كود الأجزاء المتعلقة بقواعد البيانات: كما 
ذكرنا مسبقاًء الخطوة الأولى للوصول إلى أو إنشاء قاعدة البيانات هو بإنشاء فئة (1258) متفرعة من 
:11م .6 االكود التالي يوضح الفئة (1255ع) باسم رع م1ء11ع713:50011 والتي تؤدي هذا الغرض: 


1: public class) MySQLiteHelper extends SQLiteOpenHelper 1 
2 

3: Bu Ee SEA Ee E ma SS EEG DZYEAE ASE NAME = 

48 STUER ECIO § 

5: BUSINES SEA ENE imal 5ك‎ DALAEBASE VERS HON م كك‎ 

6: ممم‎ 12 5252126 TIRAL 5 مدعت‎ STUDENT TASS = 3 
E: BECOME SESE EMAL SERT | | 1 لت‎ 5 > 

ع :ا الاق روت لا mome lS‏ 1م16 _ 3 ] :58 

5 

10: public MySQLiteHelper (Context context, String name, 
فك ع 6 15ل‎ | 

11 عدت هلاه‎ (CORN EEE, Mame, MUON, VERS OMG 

10 } 

14: 

عدم 46175 154 

16: public void onCreate (SQLiteDatabase db) { 

E JB exe SOL (LEmea lte 6 21811 5516 0) MEA MEEK 
18: primary key autoincrement not null, name text not 
5557ل‎ E 26 AR ECS E) د‎ 

AUS J 

2 

225 2 0/11 

25: مام‎ UOMO دشت 6 هت ) 206 12م كه‎ 122152535 GB, ME 

24: oldVersion, int newVersion) 1 

5-2156 5 للامادع هزه عدك ') شاك 5م 22ت 2 كلله 25 

26 this.onCreate (db) م‎ 

27:5 7 

25 


لاحظ الثوابت المعرفة في بداية الفئة (01358) (أنظر الكود من سطر رقم 3 إلى 8) والتي تحدد اسم قاعدة البيانات 
ل ورقم إصدارها 1 واسم الجدول الذي سيتم الوصول إليه في قاعدة البيانات وهو 56310626 واسماء 
الأعمدة في الجدول في مصفوفة باسم 31100110125. تم تعريف هذه الثوابت لأن سيتم استخدامها بكثرة في التطبيق 
في كل مرة يتم الوصول إلى قاغدة البيانات. 

لتسهيل التعامل مع البياتات الخاصة لكل طالب والتعامل مع كل بيانات: طالب كوحدة واحدة ثم إنشاء الفثة (ومواع) 
باسم 5610616 كالتالي: 
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PUBLICS CLASS SEUIEME 


private int id; 
private String name; 
private int age; 


(0Y ÛJ‏ امن 85 جد اد مات 


SEEMO mame, mE 2 >‏ كلد (EME‏ ك6 6ت كلاه BUS‏ 
ك ص اا 5 كملعا 
this.name = name;‏ 

EMS. ae > AE, 


< كا‎ GOGO AS إن‎ E GOSS ا‎ 


/ 
BUBE dme GEES) 
EE ME AE, 


لت كنذا LE‏ كن 


BUCE MONE SEES EME كه‎ 
O O, 


oe‏ اهف هف هم وف وهف ٠ه‏ ذه ده O‏ نم BOND‏ كن IG‏ مه 


E ل‎ 


Ke 
ليا‎ 


PUBIC SEEING Ge Name O ؟‎ 
122 HEN MAME 


N N N ثم‎ | 
SS © 


N 
دن‎ 


(SEEING 22022! |:‏ 2لئت]1ع 5 كلدو 121265 وناك 
this.name = name;‏ 


BUDE ضهة‎ Ge EASE O | 
122 لداع‎ OOO 


PUB ITE هو ع ده كك دوين‎ 35 KARE AOC) ! 
this.age = age; 


UW N NN N N N 
له دإ‎ OE 2 A O رن‎ EE 
نيا‎ 


3525 


لتسهيل تنفيذ الإجراءات المختلفة على قاعدة البيانات تم إنشاء فئة (class)‏ باسم StudentDB Utility‏ والتي يتم 
من خلالها ١‏ ستخدام كائن من الفئة MySQLiteHelper‏ المنشأة مسبقاً لتنفيذ الإجراءات المختلفة على قاعدة 
البيانات. كود الفئة 561062610117111 موضح بالأسفل: 


Ev‏ لع لإ E DE‏ ست BONE CESS OE‏ لل 


N 


MySQLiteHelper myHelper;‏ ار 
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SQLiteDatabase db; 


BMS LE 6ت‎ 016 OMHE DE VERE (COM EEE 67ت 12ت‎ SEER 
databaseName, int version) { 

myHelper = new MySQLiteHelper (context, 
databaseName, version); 


} 


BUS IME OME OBER O 
db = myHelper.getWritableDatabase )( م‎ 
} 


BUBE ORE )عد تللكت‎ | 
2ك‎ (GS L> mull C&G COO )( ( 
CIS: CLOSE )( F 
myHelper.close(); 


} 


PUBIC 2115 62-5 1622 E 0 25ت ك1 6 5 !1 للك عت‎ )( ! 
List<Student> students = new 
ArrayList<Student> (); 
CUES OE CUE SOE > 
db.query (MySQLiteHelper. STUDENT TABLE, 
MSO EEE عت م‎ A UES ORAS, E OE لك‎ Oy 
"name" )? 
SUE SIO 15 كا فت‎ 52 
لي‎ E ) ١ عصان 5 لات‎ SA 6 1ك‎ 2516 )( ( ١ 
iE O = CUE 5 عات 6 2 12ت‎ IME ) 0 
SEINE mame >  تللع‎ 5 عدت‎ GEES EERO 
int age = cursor.getInt (2); 
Student s = new Student (id, name, age); 
students.add(s); 
cursor.moveToNext )( م‎ 
/ 
()861ه16ج2 تزوقتاناةه‎ : 
return students; 


} 


PUBLIC LONG INSEE 2 5 216 129ل ع عا د ) 2 كرت‎ mame, IME 26 ! 
ContentValues values = new ContentValues )( م‎ 
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565 5 © I O OS E © 0 o 0 0 0 0و‎ 


Ke 


N 
6 


3 ذخا لى) OOOO‏ (لى) CO‏ (ي) (ي) لب) لب) (لي) 
2 ذا تت - | دحا نن كن رن SO O STS‏ 


كبر كير 
© ا 


ص سن O‏ ل مها فى دم يريم 


ES‏ تن لتر كن 


| كا BS BO‏ زا 
SS ©‏ 


9 O O O 
ل‎ O حرم آنل‎ 


42: 


حلر 
WwW‏ 


رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


44 values.put ("name", name); 

45: values.put ("age", age); 

46: Ee UE فلك‎ Mn SEe EE (MyS OM EEE Se SEU DENT مس‎ 
47 
48 


MULL, MAL USS) $ 


} 


50: 5111م‎ LORS عاض ع ك1) ع د هناك 1ك‎ (AME A) 

51 ¢ Be 6116217 قله‎ EEE Ee 1117 5 تلات اك ساك‎ Be SEU DENE اس‎ 
525 " 16 = 9, new 8 اهل قتع‎ LN {SEEING . VAL UOOE (ACY FJ 8 

55: | 

5 | 


لاحظ أن الفئة 561061101170011 تحتوي على ثلاثة دوال رئيسية تمثل الإجراءات المطلوب تنفيذها على 
الجدول 561064 في قاعدة البيانات. هذه الدوال هي: 


« الدالة ()5)مع0ن115هزمع (أنظر الكود من سطر رقم 22 إلى 40): وتستخدم للاستعلام عن كل الطلاب 
الموجودين في الجدول 50006726 ومن ثم إرجاع قائمة 1.156 تحتوي على بيانات جميع الطلبة ممثلة بكائنات من 
نوع 5]10616. لاحظ أن هذه الدالة تخفي تفاصيل الاستعلام والوصول لقاعدة البيانات حيث تقوم بإرجاع قائمة 
115 ببيانات الطلبة مخزنة في كائنات من نوع ٤٥ل‏ ں)؟. لاحظ أيضاً صيغة الاستعلام وهي: 
1 1ه سان سات : عع م لك 11ت 7 Ue y (MySOLT‏ :فك 
520 لس al ICO LUM Sy, MOL, DCL BO‏ عتم MSO Eee‏ 
حيث تكافئ استعلاء .501 التالي: 


SELE GCN THE كروك ركسعم‎ CEOM SELEIER E OEDER EK mame 


ملاحظة: في حالة الاستعلامات عن كل الأعمدة في الجدول يمكن تمرير 2111 بدلاً من المصفوفة 


11125 كما أنه عند الحاجة لبيانات محددة» يفضل تمرير أسماء الأعمدة التي تحتوي البيانات المطلوبة 
فقط وذلك لأن الاستعلام عن كل الأعمدة يتطلب مزيد من الوقت. 


٠‏ الدالة ()6ع15610هوم1 (أنظر الكود من سطر رقم 42 إلى 48): وفيها يتم إدخال بيانات طالب جديد بتمرير 
قيم الإسم ممرهم والعمر ع26. قيمة 10_الخاصة بالطالب يتم إنشاؤها تلقائياً في الجدول عن إضافة سطر جديد. 


ه الدالة (/560062ع]01616 (أنظر الكود من سطر رقم 50 إلى 53): وهي لحذف بيانات الطالب حسب قيمة 10 
التي يتم تمريرها للدالة. 


« الدوال ()مضزعمه و ()6و10ن لفتح الاتصال بقاعدة البيانات وإغلاقه (أنظر الكود من سطر رقم 12 إلى 20). 
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لاحظ أنه سيتم استخدام كائن من الفئة رازان ا 56010672108 من داخل الفعاليات المختلفة (4201171]165) للوصول 
إلى قاعدة البيانات. 


تم أيضاً إنشاء محول خاص (/ع]م6803. 115]020©) ولذلك لعرض بيانات الطلاب في القائمة (1.15]9/1617]) في كلا 
الفعاليتين: (ViewActivity)‏ و )eteActivityاDe)‏ (أنظر شكل 6-3). السبب في انشاء محول خاص 
(17م403. دوه)5ون0) هو أننا نريد تمرير مصفوفة الطلاب المكونة من مجموعة من الكائن 50010614 لعرض 
أسماء الطلبة في القائمة (1.159/168]) بدلاً من استخدام المحول الافتراضي -رع]م4133:83, هو أن القائمة 
ستعرض وتتعامل مع كائن من نوع 5610614 وليس ع5)31. الهدف هو حفظ واسترجاع الكائن 51610614 الخاص 
بكل طالب عن النقر على أي سطر في قائمة العرض (/1.15]1/167). استرجاع الكائن 5601064 سيمكن لاحقا من 
معرفة المعرف الخاص به إ1 حتى نتمكن من حذفه مثلا. 

المحول الافتراضي ]1123:8127 يدعم عرض جمل نصية فقط في القائمة (/11561/1618]) لذلك يمكن استخدامه 
لعرض أسماء الطلاب ولكن لن نستطيع عند استخدامه من استرجاع معلومات الطالب الأخرى من القائمة 
(سListView).‏ الكود الخاص بالمحول ]501062011560503 موضح بالأسفل (لاحظ أنه متفرع من 


.(BaseAdapter الفعالية‎ 
1: public class StudentCustomAdapter extends 535 2032© { 
2: 
5 Context context; 
4: TSE 2ت‎ 627 6 ST 
5: 
O كنا كر‎ 121265 5 6 16217 ECUS EOMAG APIECE ) 261115 5225 221253-26 
ES 1155-5 EUNICE 2-5 
8: this.students = students; 
98 EMS COME E > 252527 
103 1 
101 
12: public View getView ) 12 position, View view, ViewGroup 
13E OES E) 
AE 1f (view == null) { 
9 LayoutInflater inflater = (LayoutInflater) 
1O8 COM EEE £ SE ESS 2 دك كت‎ EE (CON EEE: EA YOUR ا‎ 
E 5 
1008 view = 
198 21015 11-51 5816 E 1-2158 RE 2215761165 SIEGE _ 1236 5765ل‎ BAECS, 
203 _ 2205 : 
21: TextView tv = (TextView) 
22: view.findViewById(R.id.viewName) ; 
23 
24: tv.setText (students.get (position) .getName )(( 


صفحة . 121 
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ViewHolder vh = new ViewHolder ();‏ :25 
vh. text = Tv;‏ :26 
2E view.setTag (vh);‏ 
}else{‏ 0 
ViewHolder vh = (ViewHolder) view.getTag();‏ 8 


VM. ext Sel 1! عدت‎ E ) 5 2 ك1]‎ 62265 Sek (POS 1 EON) “Ce Name )( ( : 
/ 


12621211 view; 


} 


static class ViewHolder { 
PUB INE KESEMI eW EERE; 


ر 


EB OO ))( نا لن) ذن) ذن) ثن)‎ COO 
@ كا‎ OS I حكن ره ن‎ O O | ٠ @ كف‎ 


COS |]‏ حل رك ١ت‏ ل OO‏ 


@GOverride 
4 BUCE ERE هه عه‎ 216 )( 1 
4 HEEE SEWSEN ESE 2ك‎ )( 
4 / 
4 
4 @GOverride 
4 PEE 450-2162 Ge ع‎ 12 210 (AME 59552 تع‎ |! 
4 EE EULER 52 0152126-5 7 62 ) 265 11 6 ORD 
4 / 
49: 
SOE COMER 1 
511: SEE KORO OEE LE 161ئنكت‎ EME COSMO | 
2E 168 2 ERM 252517 
535: | 
54: 
55 public void remove (Student student) { 
56 students. remove (student) م‎ 
5 تلع‎ 5 : 2-6 6 LE VDA ٠2 2 55 E 122259 )( 
595 J 
S92 


لاحظ أن الدالة ()7مع]])عع (أنظر الكود من سطر رقم 46 إلى 48) تقوم بإرجاع كائن من نوع 510676 بناءً على 
المكان position‏ التي يتم اختياره في القائمة <«(ListView)‏ وهو ما يمكن من الاستماع لحدث النقر على القائمة 
(1.15697165) واسترجاع الكائن الخاص بالطالب 511066 حسب المكان الذي تم النقر عليه. 
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لاحظ أيضاً أنه تم إضافة دالة باسم ():766201 (أنظر الكود من سطر رقم 55 إلى 58) حيث يمرر لها كائن من 
نوع 561066 لحذفه» ومن ثم تحديث محتوات القائمة (wع‏ ۷1ء11( بتنفيذ الدالة ()604ع308طآ')اء 1201115:102625. 

لاحظ أيضاً أنه في الدالة ()7/160]هع (أنظر الكود من سطر رقم 12 إلى 34) يتم انشاء الواجهة الخاصة بكل 
سطر باستخدام الدالة ()1511366 حيث يتم تمرير المعرف الخاص بملف تصميم الهيكلية وهو 


ist_layoutا_ayout.studentا.R‏ حيث يستخدم التصميم التالي: 


SS EE SOM N O ناتك لت‎ EE د ا‎ 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
:1ك تلك لت‎ LE VOU WIC MECN EEO E 
تدك لت‎ EG SEA OU E Me OME EMAC تم‎ mE 
ARG E ك للدت‎ AOE CME AE OR e E ECA 
2120112 01-0 SDAA IINIEOEEOM 1 4 1ك‎ 20 AACE vi Ey VEEN CaN 1 
android:paddingLeft="@Gdimen/activity_ horizontal margin" 


android:paddingRight="@dimen/activity_horizontal_ margin" 
android:paddingTop="@dimen/activity_ vertical margin" 


id="@+id/viewName" 
avout WIG ERSIWEAD COME CN E 
عت 51 ا‎ ME GS E EA CE OMI CR E 


تصميم الواجهات الخاصة بالتطبيق يتم باستخدام ملفات التصميم Layout‏ التالية: 


أولاً: تصميم الواجهة الرئيسية (/42119716.م2121) موضح فيما يلي: 


> 


<TextView 


ARE EO GE 
UNCLES 
EMELE O LOLS 
SEES ESI لدت‎ 1 CO 

: text lex EVI eW /> 


201010112 O Û O 
AMER OG 
</LinearLayout> 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
SmI MSE EOSLS- LMEEB:// SEReMaA SE. ARO ONG COM EOL SL 
android:id="@+id/RelativeLayout1" 
:كت 1ك تلك لات‎ AMO E EGE MS اجات 5ت‎ PAE E 
ARA EOE SAMO E MeO ES imal EM OAM E 
SEES OE CM لوت لدع عردب ١ك كك عا 2 عا‎ 
android:paddingBottom="@Gdimen/activity_ vertical margin" 
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android:paddingLeft="@Gdimen/activity_ horizontal _ margin" 
android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
tools:context=".MainActivity" > 


<TextView 
android:id="@+id/tvStudentDB" 
AME EOMG E 65ت ال‎ GE MS ES COME EM E 
AMEE 12ت 1121 :1 1ه‎ MEMO MES ESI COR E CME 
تك لله‎ 0 10 E LAVOE a SME ا ست لدت‎ KOP > EEE 
SAECO SAMO E CEME OTO ZOM EA LS E EUE 
AREA EOE SAMO E Ma تمه 1 رو‎ 2 
android:text="Student Database" 
ARG E ك للدت‎ : EE 6 5 122-255 
2118 5101: EC ES ELE OLO م‎ 
SB EEO 
android:id="@+id/viewAllBtn" 
ARE EOE SAO E EGE MS 751723 COM EEN E 
عذك لت‎ EEG EA 176 E OES IES COM EEE 
android: layout_below="@+id/tvStudentDB" 
16ت 6116 11ت‎ 121 2015 CEME 62ت 22 مك المت‎ ASE EE 
مت 0 2 1155700165 :61 01 لت‎ SOP 
android:text="View All" /< 
SBE IE OR 
android:id="@+id/insertBtn" 
AEE OG EA OE IEE MS E COM Ee E 
AMEE ES OE MEE DES ES COME CE 
android: layout_below="G@+id/viewAllBtn" 
21ت تلك للك‎ E a YOU E COME CE OM ZORE A LS EEE ll 
د اق أده قام املد‎ LAVOU E, 11121126 LATO = SE 
مااع ت 1 2 عت 6 411617 ه61 1ت‎ 
BU EEO 
android:id="@+id/deleteBtn" 
1ه ملت 1ت‎ 641: LEA VO E GE MS SO COME EM E 
1ك تك للك‎ E AVS E MEMEO MES MESES COM ست‎ 
android: layout_below="@+id/insertBtn" 
SAE ORG : AMO E CEME OO AOE 1ت‎ EE 
aE 11ت‎ A VOU E MS EO EOS SE 
يعدت :1ك 1ن لكت‎ Dee Eel 
</RelativeLayout> 
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ثانياً: تصميم واجهة الإدخال (/10561]/411910) موضح فيما يلي: 


> 1112© 3213570111 
xmlns:android="http://schemas.android.com/apk/res/android"™ 

Samim S2 EOSLS- 6 65 2/1 SEMeMaA SAREE SLA COM EOL SL 

ARSE OLS لكان 1د د‎ 4 7 AAA RME AE LAVOE IL 

311701 0214: la vyOUE wi dt RM Ma ECEM Patent 

ست 21م MeO MES Ama EE RM‏ 12ت 1121 :كنك تنك لت 

android:orientation="vertical"™ 
android:paddingBottom="@Gdimen/activity_vertical_ margin" 
2120116 510 : 5 20102231255 6 E> 4 meRM Aa CE UN EY DOE AON EAN Maro 


android:paddingRight="@dimen/activity_ horizontal margin" 

android:paddingTop="@dimen/activity_ vertical _ margin" 
tools:context="com.example.sqlite. InsertActivity" > 
<TextView 

ECE OLCS LO OFAC CURIA ا‎ 

AMEE OG E EOE SE MS AS COME CE 

MeO MES ESE COMER El‏ 1125016 :16ت ترك لل 

ARO كلدت‎ 2 EEE 5122 > 24 SO 

AREA EO CO : عدت ع‎ 6 EYE > OLO 

EMG 11212116 GES ES CEM EE E ll‏ تك لت 

AMEE GG 6ت‎ MSE EE GEMAR 


<LinearLayout 

la VOU E idi R> Ma EER Palen‏ :02124 01 11ت 

AREA EOE E HAMO E 1588616105 ESO COM EEN E 

ARA لل : إن للدت‎ 217616 MeaESI NEO > 20A 

8 

<TextView 
android:id="@+id/tvStdName" 
:14ت تدك له‎ la VOUE MICE R> WES OOM EOE 
ARE EOE SAVIO E MEO MES MESS CON ECEME 
ARE EO O : ع عدت ع‎ SA 26-1 مك ة‎ 
5202010: text="Name" /> 

ITE CES E 
android:id="@+id/insertName" 
:14ت تك 1ك‎ la YOU E dE MS IES OOM ECEME 
1ك تك رت‎ 61: HAMO E MEO ES ES COM ECEME 
1161م عاممة‎ LAVOUE_ WOELCAES 14 
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android:ems="10" > 
<requestFocus /> 
SEQA 15 
</LinearLayout> 
<LinearLayout 
ARE EOE AVON E 1ن‎ 512 1 61 ae E 
AMEE RG SA OUI Me O MES ESS COM ECEME 
MEA EON 1: 1121 15ت‎ 2-20 EOS OO 


<TextView 
android:id="@+id/tvStdAge" 
ARE EOE SEA O E EG ES ES COM EEN E 
تلك لت‎ OMG 1121518 Me HOMIES ESS COM ECEME 
ARG E دك 2 : ك للدت‎ 6 5 12-55 
android: text="Age"/> 


SEG ERE E 
android:id="@+id/insertAge" 
11ت عذك لت‎ E LE MOTE WICC _ COM ESR 
تلك رلك‎ GE SEA OME E EO IES ESS COM ECEME 
AMOEOLES LA YVOUE WOELGRES 14 
AME THON GEES IO > 
</LinearLayout> 
15/015 OR 
1ك 2ك 10ت‎ E > IC A ACO DRE عا‎ 11 SEE EE E 
AGE OG EA OU E IGE MSE COM EER E 
AMEE OG ES OE EES ES ES COME CME 
AMOEOLES LAVOE 67128571551 EER EOE 
تلك لت‎ 02174: AVOUE 1 كن ت‎ 22166 - OAPI 
android:text="OK" /> 
</LinearLayout> 


واجهتا العرض (1716420119717) و الحذف (راز1۷)ءAء)ء1ء0)‏ تستخدمان التصميم الافتراضي للفعالية 
(/711 اك هراوز ])» أي أنه ليس لهما ملفي تصميم للهيكلية. 


قبل كتابة الكود الخاص في الفعاليات (وع1ازناء۸) يجب التأكد من إضافة إذن الكتابة للذاكرة الخارجية لملف 
الوثيقة وع11م/2. كذلك يجب التأكد من الإعلان عن كل الفعاليات التي يتم إنشاؤها في ملف الوثيقة 51ع2/13011. 


سنقوم الآن بتفصيل الكود الخاص بكل فعالية (رtزA)1۷):‏ 
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أولاً: الفعالية /4]10716/م:2 والكود الخاص بها موضح بالأسفل. تعرض هذه الفعالية أزرار تنفيذ الإجراءات 
المختلفة. عند النقر على كل زر يتم تشغيل فعالية جديدة لتنفيذ الإجراء المطلوب. فمثلاء عند النقر على الزر 
1B tn"‏ سم" (أنظر الكود من سطر رقم 9 إلى 18) يتم إنشاء هدف صريح (106626 11016م:1) يحدد الفعالية 
(tyززاWAهVi)‏ والتي سيتم فيها عرض الأسماء. بعد ذلك يتم تشغيل الفعالية (/1157167ع7.4اع171) بتنفيذ الدالة 
(171370)ع لش »ta‏ حيث يمرر الهدف (6]مع106) كمدخل للدالة (سطر رقم 16). 


LCE VEY >‏ 5 كت 2 ده EY‏ لد لك 6 2 524 1 13 2-5-5 تلت كن لكل وناك 


@GOverride 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
SEE CORMIER EUEY (E A O UE aC Ey Ma A) 
Button viewAllBtn = (Button) 

EM SE MOV CWE VI CG (RSE UN جع كلك !لضن ت‎ 
viewAllBtn.setOnClickListener (new 

ORCI TERES EERE E )( 


< e Ce 1 e حل ل‎ Ce کا نذا‎ 


GOverride 
BUCE OME سه‎ E e O 
Intent intent = new 
عسات 6 كا‎ (MSA AE EV E E AS EL GEN E CLASSE 
هات 55د‎ EEE EE (E CRE) 
/ 


فقا همه هه اهم مهمه هف وهم وه نه HO‏ نح يبن كىن كن GO‏ تب مه 


8 
EuLLon 1nSserlLELIn = (EBULLOoN) 
EM SR AMO EWEY EE (RTE TSE E BEM) : 
insertBtn.setOnClickListener (new 
OnClickListener () { 


لكك E‏ د کک کک کک ن 0 
E ee)‏ 5-0 


N 
دن‎ 


UW WW WU WN N N N N N 
BEB UNH © كا‎ =I 35 U E 


@GOverride 
BUCO IME VONO ORCL E ew ل‎ 
اكت 6 لا‎ 12165 > MEW 
Intent (getApplicationContext )( , 
1125612 ع شع‎ MEE م ([ (( 258 لع‎ 

2ت 5 لجل ) 7( 2ع 14 سه ع كش عا مراك 55 


/ 
)م‎ 
BUWE رتنع‎ Gele EEN < (BLE EOM) 
EM SIMO ك1 : 1 ) ك1 رز كيرت‎ Ie LE EEB ER) : 
deleteBtn.setOnClickListener (new 
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! () مكاح ع 5 1شعلات SSE OME‏ 


36 

351 @GOverride 

55: PUC INE كلت سه كلدو‎ (WA eW WM 

39 8 Intent intent = new 

40: Intent (getApplicationContext (), DeleteActivity.class); 
Al; 5 5 له عاك شع مك‎ EV (ADE 6122 ( 

42 } 

م ]1 46 

44: ( 

45:} 


ثانياً: الفعالية 7716078119016 وهي المسؤولة عن عرض أسماء الطلاب والكود الخاص بها موضح بالأسفل. 
لاحظ أن هذه الفعالية تقوم بإنشاء كائن من نوع :901064108170115 للربط مع قاعدة البيانات (أنظر سطر رقم 
6» ومن ثم الاستعلام عن كل الطلاب من خلال الدالة ()15م8411560106]ءع (أنظر الأسطر 10 و11). قائمة 
بيانات الطلبة المرجعة 560106265 <]1156>59]601060 يتم تمريرها إلى محول من نوع 
tudent Custom Adapter‏ لتعبئة القائمة wع‏ 1۷1ء1 (أنظر سطر رقم 12). 


PUC INE CLASS UNE WAGE VN Y كات 6 22ت‎ LE 7ع ين عاك شعاد‎ 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
StudentDBUtility dbUtility = new 
5 6114 تت لاك ست‎ EY (ERIS, MySOLI EEE lI per : DATABASE NAME, 
MySQLi1teHelper. DATABASE VERSION) م‎ 
SUE 125:7 OBER DE 
List<Student> students = 
GURE الل‎ 67 ١ 0 لت 016 6 015 لضع ت‎ 685 )( 
StudentCustomAdapter adapter = new 
35 6 0111 6 92115 EOMASAPECE (EAS, 5 621221265 
this.setListAdapter (adapter) ; 
SEE 53ت اك‎ )( 


ا ذذا كن حد إن وك ال GOGO‏ كا < 


OO RS E @ 55 0 0 0 U 00 0 O‏ 5 ا O‏ اذه 


ثالثاً: الفعالية 105648219167 والموضحة بالأسفل ومن خلالها تتم عملية إدخال بيانات الطالب. لاحظ أنه في هذه 

الدالة يتم أيضاً استخدام كائن من نوع (1][11116 50010601108 (أنظر سطر رقم 11) لإدخال بيانات الطالب من 

خلال الدالة (125615160106210. عند النقر على زر الإضافة ””16ع105“ يتم تنفيذ إجراء الموضح في الأسطر من 
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6 إلى 43 حيث يتم قراءة العناصر المدخلة (الاسم والعمر) ثم تنفيذ الدالة (10561656106710 (أنظر سطر رقم 
3). اذا كانت قيمة 16[ناوع7 المرجعة تساوي -1 فهذا يعني أن عملية الإضافة لم تتم بنجاح حيث يتم طباعة رسالة 
هآ تبين ذلك (أنظر الأسطر من 34 إلى 43). لاحظ أيضاً أن الاتصال مع قاعدة البيانات يبدأ في الدالة 
006210 (أنظر سطر رقم 8). يبقى الاتصال مفتوحاً حتى يتم إغلاق أو ايقاف الفعالية عند تنفيذ الدالة 
onPause()‏ (أنظر سطر رقم 51( والتي يتم فيها إغلاق الاتصال مع قاعدة البيانات. 


BUC INE CLASS IRSEREACE EVN E كك عدت‎ S Ae ل‎ 27 


EditText nameTxt; 
HEM EME E ASCE, 
SEE eRE 1ع قاط‎ VY COWES EYE 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 
SEE GOMER EVE EE TE 165 E AEE EY SE E) 
65121617 < Mew 5 611 سك‎ EDE UIE EY (ERS, 
MySQLiteHelper. DATABASE NAME, 
MS OLE eel per . DATABASE MER STON) 
SOU ELEY. OPER )١ 
nameTxt = (EditText) 
E SE كان 15 مله‎ 111601 (RE TE SEE E Name) 8 
ageTxt = (EditText) 
ES E MOVES EO E TE 7 عدك اك كته‎ EASE) 
BUI E OM COME MUM SELE EEE — (BUE EON) 
EM SE IMOVIE WE ك1‎ CR TEE CORE EMIR 5 كلع عدت‎ EM) 
SORE لك‎ EMURS 3 12 EBERN. SEE ORCL HE EES EERE E (MEW 
OnClickListener () { 


< )© GO AMAS OBE ODS |] 


فقا oe‏ هه هه ممه هف وهم وه هه BUND HO‏ كن O GO‏ 


ىا 


لكك لك لك كك كك لك 000 
rO‏ 


N 
دن‎ 


UW WU WNN N N N N N 
حير‎ UOUODNEH © كا‎ 060 =I O U E 


@GOverride 
BUCO IME TOME ORC E e ل‎ 
if (nameTxt.getText () !=null && 
ageTxt.getText() !=null) { 
String name = 
mame GE. 02 6 2ك‎ 6 )( CEOS IMS E 
int age = 
REC 0 عت‎ AE SE NE (ASE E OSE EEE 16ل عدت 5ع : () عا‎ DE 
Tong EeSUl E > 
dbUtility.insertStudent (name, age); 
1f (result == -1( { 
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Toast.makeText (getApplicationContext )( , "Error occured 
wn Ee mse ERS Ga lal, MOISE LENGTH SHOR) SMO OE 
jel se { 


Toast.makeText (getApplicationContext (), "Item inserted 

51266 5ت‎ UN, Koos e LEONEL SHORE) SMO )( 
nameTxt.setText (""); 
ageTxt.setText (""); 


NE 
/ 


@GOverride 

MONA OMEaUSe )( |!‏ 02665940 كر 
م () super.onPause‏ 
SUES EY. CLOSE )( -‏ 
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BEEBE E SS حر‎ 
OS A SS حنم رك‎ GOS © 


حلم 
ىا 


ON‏ لنت ON‏ له 
كت کا كن 


U1 
حلر‎ 


5 


5 


رابعاً: الفعالية راز۷ناAء‏ )1ء( والتي يتم من خلالها الحذف عن طريق اختيار العنصر المراد حذفه من قائمة 
(1156]9/1617]) ومن ثم النقر على زر ع]ع1ء17 في القائمة الجانبية. الكود الخاص بهذه الفعالية موضح فيما يلي: 


7ع SELON‏ 5 كلت عت Dele ECAC EVN EY‏ 25-5 للك ك ال لكر 


SEUOSERMEDSUELL LEY COVELL 
StudentCustomAdapter adapter; 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
060111237 = new StudentDBUtility (this, 
MySQLiteHelper. DATABASE NAME, 
MySQLiteHelper. DATABASE VERSION) م‎ 
ادي كله‎ E OBER 
List<Student> students = 
SUE 151لا‎ 6 VY. ته‎ EAL 1 5 6 014212155 )( 
adapter = new StudentCustomAdapter (this, 
SEUQdeRNES) 7 
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this.setListAdapter (adapter); 
this.getListView )( .setOnItemClickListener (new 
OnItemClickListener )( { 


@GOverride 
public void onltemClick (AdapterView<?2> 
parent, View view, 
mE OOS EMO, Lomo 226 
SEMER SEEM E = 
)5 5 0160215 E) Par 21116 GCE LECMAEEOS N EA OM (POS عا 1ك‎ 1 OR) 
showPopup (view, student) ; 
/ 
م‎ 
/ 


210 5 لدع (ew uieW,‏ 5ك هشه كلدو 16ل كناك 
Student) {‏ 

PopupMenu popUpMenu = new PopupMenu (this, view); 
popUpMenu.getMenulInflater )( .inflate (R.menu. 
contextmenu, popUpMenu.getMenu () ) م‎ 

popUpMenu.setOnMenulItemClickListener (new 
OnMenuItemClickListener )( { 


@GOverride 
public boolean onMenuItemClick (MenulItem 
menultem) 1 


( () “للع تاه : 6 لض كاك عا د ) 6 كلت 1ت 01 6 GELE EES‏ 617 1ك SOE‏ 
م (student)‏ ع202057ع2 . عدع 6م503 
return false;‏ 
} 
م 
م () 51017 popUpMenu.‏ 
/ 
@GOverride‏ 
PEOEEE ECO MONE OmMEaAUSeE )( |‏ 
م () super.onPause‏ 
() 53 هللات ١‏ راع لاله ع مه 
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ا ا ا د د 
yg RNS!‏ 


E OG OG O لن) ذن) (ن) ذن) 3)) ثن) (ذ))‎ <3 |3 3 <3 3 3 DS 
622 KO CO تت 1]) 3 لا حل إن كت ل‎ GCG 52 ل‎ GO لتك حنم ار‎ 


حلم 


EEE EE E زر‎ 
05 TS حد يرن‎ GOS © 


حر ان 
قا O‏ 


O ON ON 
كن‎ E کی‎ 


O1 دن‎ 
ON E. 
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لاحظ أن الفعالية تستخدم أيضاً كائن من نوع '11169]] 51061101 للوصول لقاعدة البيانات (أنظر سطر رقم 9)» 
حيث يتم في البداية الاستعلام عن كل الطلاب من خلال الدالة ()41156106265ععوعرضها في القائمة 
(1.1565/1619]) باستخدام محول من نوع 61]م5]11060]0105]00403 (أنظر الأسطر من 14 إلى 17). تم أيضاً 
إضافة مستمع (1عمع]15.]) من نوع (إعمعistاtemC1ickا0n)‏ للاستماع لحدث النقر على أي سطر في القائمة 
(11569/1617) (أنظر سطر رقم 18). عند اختيار أي طالب من القائمة يتم استرجاع الكائن 5600674 الذي تم 
اختياره ومن ثم يتم عرض قائمة سياق ماع71 )200212 تظهر زر الحذف ع)ع[ع5. يتم إنشاء قائمة السياق بتنفيذ 
الدالة ()منامه0120طو والتي يمرر لها كائن 5610646 المراد حذفه (أنظر الأسطر من 25 إلى 27). من خلال 
الدالة em C110‏ nMenuItه‏ (أنظر الأسطر 44 و45) يتم تنفيذ أمر الخذف عند النقر على زر 106166 حيث 
يتم تنفيذ الدالة ()74ع16165610ع0 الموجودة في رانا ا 5610641015 ويمرر لها رقم المعرف الخاص بالطالب. 
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أسئلة على الوحدة السادسة 
ما الفرق بين تخزين البيانات في الذاكرة الداخلية وتخزينها في الذاكرة الخارجية؟ 
قم ببناء التطبيق الموضح بالأسفل: يقوم المستخدم بإدخال كلمات وحفظها بالنفر على الزر "535:6". 
الكلمات المدخلة يتم حفظها في قائمة من نوع <1.156>511158آ:81733,. عند النقر على زر "5101" يتم 
طباعة الكلمات المحفوظة باستخدام ‘Toast‏ 
أحد مشاكل هذا التطبيق أنه عند حفظ بعض الكلمات وتدوير الجهازء يتم فقدان كل الكلمات المحفوظة. 
السبب في ذلك أن النظام يقوم تلقائياً بإنهاء الفعالية (421103107) وإعادة تشغيلها عند تغيير إعدادات 
العرض. قم بعلاج هذه المشكلة باستخدام التفضيلات المشتركة (SharedPreferences)‏ لحفظ الكلمات 
واسترجاعها عند إعادة تشغيل الفعالية. 


AM‏ 8:30 وج 
Collect words |‏ 


Type a word 


قم بالتعديل على تمرين 6-2 وذلك بإضافة فعالية جديدة باسم 56212/01157167 يمكن من خلالها البحث 
عن طالب باستخدام الأسم (أو جزء من الأسم). 


في تمرين 6-2» يتم تنفيذ إجراءات الاستعلام والإضافة والحذف على قاعدة البيانات. قم بتعديل التطبيق 
لينفذ إجراء التعديل (ع:13م1]) على بيانات طالب محدد. قم أولاً بتعديل الفئة StudentDB Utility‏ 
وذلك بإضافة دالة باسم ()0136651110626106]2115م1 والتي يمرر لها ثلاث قيم هي: رقم المعرف 10 
الخاض بالطالب المراد:التعديل على بيانات» اسم الطالب المعدل وغمره المعدل. قم بعد كلك بالتعديل على 
القائمة المنبثقة التي تظهر في الفعالية (000157107شرع]17616) وذلك ليتم إظهار زر باسم ”0366م“ عند 
النقر على اسم أي طالب. عند النقر على زر "مةل مل" يتم إظهار فعالية لتعديل على البيانات القديمة 
التي تظهر في عناصر الإدخال من نوع غ801]1:2. 


0 


في تمرين 6-2 تم إنشاء قاعدة البيانات باستخدام فئة متفرعة (subclass)‏ من الفئة 
.SQLiteOpenHelper‏ قم بإنشاء قاعدة بيانات مطابقة لتلك المستخدمة في التمرين باستخدام الأداة 
البرمجية :812056 Database‏ iteاSQ»‏ ثم قم بعمل التعديلات اللازمة لاستخدامها بدلاً من الفئة 
.SQLiteOpenHelper‏ 
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الوحدة السابعة: 
مزودات المحتوى 
(Content Providers)‏ 
يتعلم الطالب في هذه الوحدة: 


”7 مفهوم مزود المحتوى (1ع270110 ٤"عntه€)‏ واستخداماته. 


> مكونات مزود المحتوى وطريقة الوصول إليه للتواصل مع قواعد البيانات الموجودة ضمن تطبيقات 
أخرى. 


> التدريب العملي على إنشاء و استخدام مزود محتوى يتيح الوصول إلى قاعدة بيانات. 


لدراسة هذه الوحدة لابد من الإلمام بإنشاء تطبيقات أندرويد المعتمدة على قواعد البيانات كما تم تفصيله في الوحدة 
السادسة. 


توفر مزودات المحتوى (ءإمل¡0vإ۴‏ 002]626) الإمكانية للوصول للبيانات (قواعد البيانات أو الملفات) من 
تطبيقات مختلفة. فمثلآًء اذا أردت مشاركة قاعدة البيانات المستخدمة في تطبيق ماء يجب إنشاء مزود محتوى 
)Content Provider)‏ حول قاعدة البيانات ليوفر الوصول إليها من تطبيقات أخرى. فكرة مزود المحتوى 
)€0ntent Provider)‏ تشبه إلى حد كبير هيكلية العميل/المزود )C1ient-Server Architecture)‏ حيث يمثل 
التطبيق الذي الذي يسعى للوصول للبيانات دور العميل (011626) بينما يمثل مزود المحتوى دور المزود 
(5615761). شكل 7-1 يوضح فكرة عمل مزود المحتوى (20110617 ٤ہعtہCo):‏ التطبيق 1مم يستخدم قاعدة 
بيانات حيث لا يمكن الوصول إليها إلا من خلاله. لتمكين تطبيق آخر 2م85 مثلاً من الوصول لقاعدة البيانات 
الخاصة ب 1 مم۸ واستخدامهاء يجب إنشاء مزود محتوى (20110617 002]604)) يوفر عدد من الدوال ( ,01161 
update and delete‏ ,1زهءوم() التي يمكن تنفيذها من أي تطبيق بعيد للوصول لقاعدة البيانات. 

يوفر نظام أندرويد عدد من مزودات المحتوى (2180110615 Content‏ in-tاBui)‏ للوصول إلي بعض قواعد 
البيانات الخاصة بالنظام مثل جهات الاتصال (65ع000263)» مخزن الوسائط (ع2460135601): المفضلات 
»))B00okmarks(‏ والإعدادات (وعم)هو) وغيرها. على سبيل المثال» يستطيع أي تطبيق طبقاً للصلاحيات 
الممنوحة له من الوصول لجهات الاتصال الموجودة في الجهاز وذلك لقراءتهاء التعديل عليها أو استعمالها لأي أمر 
آخر. 

في هذا الفصل سنطرق إلى إنشاء مزود المحتوى (210171061 200214626) للوصول إلى قاعدة البيانات الخاصة 
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Content 


مزود المحتوى -- 


EE, EE‏ مدي 
56 مدمر 


شكل 7-1: الاتصال بين الفعالية (و٤ (Activ‏ ومزود المحتوى Provider)‏ 1)00266124 
إنشاء مزود المحتوى (Content Provider)‏ 


يتم إنشاء مزود المحتوى (270710617 26ع006) عن طريق إنشاء فئة فرعية (1355ع506) من الفئة 
android +101‏ »ومن ثم كتابة كود في بعض الدوال التي تتحكم بالوصول للبيانات 
وهي: 


ه الدالة ()ع)جع')من: وهذه الدالة يتم تنفيذها تلقائياً من قبل النظام عند إنشاء مزود المحتوى لأول مرة ويتم فيها 
تنفيذ الإعدادات الضرورية لتشغيل مزود المحتوى. 


ه الدالة :queryO‏ يتم تنفيذ هذه الدالة من قبل الزبون غمع0'11© لاسترجاع بيانات من مزود المحتوى. الكود الذي 
يجب كتابته في هذه الدالة يحدد نوعية البيانات وطريقة استخراجها ومن تم إرجاعها للزبون مغلفة بكائن من 
نوع .Cursor‏ 


ه الدالة :insert)‏ هذه الدالة یتم استدعاؤها عند إضافة سطر TOW‏ إلى في قاعدة البيانات. يجب كتابة الكود 
اللازم في هذه الدالة ليتم الإضافة إلى قاعدة البيانات ومن ثم إرجاع معرف 01 للسطر الجديد. 


CompileTimeError, http://www.compiletimeerror.com/2013/12/content-provider-in-android.htmal ١ 
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ه الدالة :update)‏ يتم تنفيذ هذه الدالة عند الحاجة لتعديل بعض البيانات من قبل المستخدم. يمرر لهذه الدالة 
القيم المعدلة لسطور معينة ومن ثم يتم إرجاع عدد السطور التي تم تعديلها. 

ه الدالة :delete)‏ وتستخدم في حالة حذف سطور محددة في قاعدة البيانات حيث ترجع هذه الدالة عدد السطور 
التي تم حذفها. 

ه ()ع6مل19)مع: وترجع نوعالبيانات HTML «text Jîan) MIME Type‏ وغيره). 

قبل شرح طريقة إنشاء مزود المحتوى عملياًء لا بد من شرح بعض المفاهيم الأساسية المتعلقة باستخدام مزود 

المحتوى (1ع2101101 )Content‏ والوصول إليها. 

(The Content UÜ RI) معرف الوصول للمحتوى‎ 


قد يحتوي الجهاز على أكثر من مزود محتوى (280971061 0026626©) يتم الوصول إليها من تطبيقات مختلفة. 
لذلك» لا بد من طريقة لتمييز كل مزود محتوى. بالإضافة إلى ذلك» فإن مزود المحتوى قد يوفر الوصول لمحتويات 
متعددة (أكثر من جدول في قاعدة البيانات)» لذلك لابد أن تقوم التطبيقات التي تريد الوصول لمزود المحتوى من 
للمحتوى .(Content URI)‏ 
معرف الوصول للمحتوى ۸81ل 0021624)) مشابه لروابط الصحفات على شبكة الإنترنت» وهو عبارة عن جملة 
معرفة تبدأ بالمقطع //:002601 وتتكون من أكثر من جزء: الجزء الأول يسمى 110117 ويحدد مزود 
المحتوى. عادة يستخدم اسم الرزمة package‏ للفئة الخاصة بمزود المحتوى. مثال: 
content://ps.edu.ucas.mycontentprovider‏ 
الجزء الثاني يتم إضافته للجزء الأول ليحدد الوصول إلى جدول معين في قاعدة البيانات. فمثلاً» للوصول إلى 
الجدول 561064 الموجود في قاعدة البيانات لمزود المحتوى 1ع5.6011.11625.10130011]611010110م2 يتم إضافة 
اسم الجدول 5010601 بعد 4111101167 ليصبح: 


content://ps.edu.ucas.mycontentprovider/student 


للوصول إلى سطر محدد في قاعدة البيانات» مثل تعديل أو حذف سطر محددء يتم إضافة معرف السطرء وهو عادة 
رقم يزداد تلقائياً وممثل بعمود في الجدولء إلى نهاية معرف الوصول 171:1 0216714) ليصبح: 


ps.edu.ucas.mycontentprovider.StudentProvider/student/3 
حيث الرقم الأخير يحدد معرف السطر المراد الوصول إليه.‎ 


عند القيام بأي إجراء على قاعدة البيانات مثل الإضافةء الحذف» التعديل أو الاستعلام؛ يتم تمرير معرف الوصول 
للمحتوى 1111 ,عه للدالة المطلوبة لتحديد المحتوى المطلوب تنفيذ الإجراء عليه. فمثلاء لحذف السطر ذي 
المعرف 10-3» يمكن تنفيذ الدالة ()06161 وتمرير معرف الوصول الموضح بالأعلى. 
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الإعلان عن مزود المحتوى في ملف الوثيقة (5)0ع371211) 


حتى يتعرف النظام على مزود المحتوى» يجب الإعلان عنه في ملف الوثيقة (01211656) الخاص بالتطبيق الذي 
أنشئ به مزود المحتوى. على سبيل المتال» الكود التالي يتم إضافته إلى ملف (1/56مة7/1): 


<provider android:name=" 

PS CISL UCAS 1117 كت 2 12 مت‎ EPL OVICEE : لت ك 1] 6 د‎ EEE OVI GEE 
211016116 6711018 aU 1د درف ملك‎ 0115 S> 
ps.edu.ucas.mycontentprovider.StudentProvider" 
android:exported="true"/> 


حيث أن الخاصية 2201010:3111011165 تحدد معرف مزود المحتوىء بينما الخاصية عمصهم:1dهإل‏ مه تحدد 
اسم الفئة (01355) التي يتم فيها تطبيق دوال مزود المحتوى» وفي الغالب تستخدم نفس القيمة المحددة ل 
.android:authorities‏ الخاصية dع)oid:expor andr‏ تحدد ما إذا كان مزود المحتوى (Content Provider)‏ 
متاح للتطبيقات الأخرى (android:exported="true")‏ أم لا .(android:exported="false")‏ 


(Content Resolver) مستخرج المحتوى‎ 


الوصول لمزود المحتوى (17ع270:710 26ع0026) واستخدامه يتم باستخدام محلل المحتوى (Content‏ 
(01761و186؛ وهو كائن (6ع06[6)) يمكن الوصول إليه بتنفيذ الدالة ()600216621616650151]عج الموجودة ضمن 
Context‏ icationاpمA.‏ باستخدام مستخرج المحتوى (17ع000162]1650197))» يمكن تنفيذ كل الدوال التي 
يوفرها مزود المحتوى مثل 16هع105» (ق161ان» 6]ء1ء0 وغيره. أي أن مستخرج المحتوى (ContentResolver)‏ 
يتواصل مع مزود المحتوى (61ع280710 غ00262)) لتنفيذ الإجراءات التي يطلبها التطبيق الزبون غ+مع11©) 
(«متندء ناممى (أنظر شكل 7-2). 


Process A 


Application A 


Content Resolver 


Process B 


Application B 


Content Provider 
Method1() 
Method2() 


Method1() 
Method2() 


Methodn() 


Methodn() 


شكل 7-2: الوصول لمزود المحتوى er(‏ 01ا۴ 00246126)) باستخدام مستخرج المحتوى )ع٤٥ )C‏ 
Resolver)‏ 1 


Pact Publishing, https://www.packtpub.com/books/content/what-content-provider ١ 
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تمرين عملي (7-1) 


سنقوم في هذا التمرين العملي باستكمال التمرين الخاص بقواعد البيانات (تمرين 6-2( »والتي تم تفصيله في الوحدة 
السادسة »وذلك بإنشاء مزود محتوى (Content Provider)‏ لتمكين التطبيقات الأآخرى للوصول إلى قاعدة 
البيانات المنشأه مسبقا باسم 5]1066016. 


الخطوة الأولى في إنشاء مزود المحتوى (22071061 ntentدC)‏ هي إنشاء فئة (01255) متفرعة من الفئة 
10710 بعد ذلك نقوم بكتابة الكود في الدوال الموجودة بها للتواصل مع قاعدة البيانات واستخدامها. 
اه أن: الفئة الج را .يك وها طمن كبن راع البياناك السابق (وليس كين لي جرد الشكل 
يوضح الكود الخاص بالفئة الجديدة. 


NE لت 5125م‎ 25-5 SEUIEMEEEOMI GER 5ك لكت عا عدت‎ COMER E EEO A GEE 
2: 

5 MySQLiteHelper helper; 

4: BIBLE SEALE EREN SEER سك سات‎ MN > 

5: 55 CAUCE SS SOLE ١ 2 عا مكلت ع د : مت كت 1 1 1ك ع جلت 6 5ه‎ EE ON OEE 
6: 

I UriMatcher uriMatcher = new 

رت ل NO‏ عدت كات 6 121:13 عنا) عدت ات 1111516 عرلا SE‏ 

58 

105 BEE EE 326516 Ema هله‎ 120916 SUD EN AEE > 18 
115 1913م‎ 553516 E aA E E ةن 85_ قلع ولق‎ EE CORB كك‎ 
1 

13: @Override 

14: public boolean onCreate() | 

5 Mele > Mev MUSO EEE OEE ) 3115ل‎ OE ECOMEES E O 
16: MySQLiteHelper. DATABASE NAME, 

17: MySQLiteHelper. DATABASE VERSION) ; 

LOE uriMatcher. addURI (AUTHORITY, 

ساقت ا E RODEN‏ ان تك كن لت تراك ما SAUDE‏ عدت ملكتت الات MS OEE‏ 2 19 
uUrFIMatcher. 2001181 (AUTHORITY,‏ اك 

215 11195 1 5116115812 STUDENT 1281+" / #"" 6 

22 CEOICE SS RUDENIN RECORD 

25: 

24: return false; 

2908 J 

26: 

275 2 06/5 1 

28527 BEBE UE RSE (UE DEN, COME EVA UES a eS) 1 
29 mE me 5 1145 علدت كت 1111205 عدن‎ Ma ECR (UES) 
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ome د 16د‎ 
للك‎ (EES SS CHORCE UDI HAS EE) ١ 
SQLiteDatabase db = 
helper.getWritableDatabase )( م‎ 
فلك 2 لوكا‎ MSE E (MYSORE CHE الل لت اسان نات © عدت هر‎ 
N 0 


ERIS. 0 6 6 951 ك5‎ )( OSCE COR 5 11ت‎ 6535 SO Ie E )( : 1216 6 1 2 612192 ) 
EAL, لاس‎ 2 
Jel seê { 
throw new IllegalArgumentException ("Invalid 


WELA) ° 

/ 

EE DER EN OA 255 (LE SM EERIE E AU REISE TR E 
MZ ECEME LEE o SUDDEN TASTE TAO) 7 
/ 


@GOverride 
PEELE EME Cele Ee (UE لدعلل‎ SENE Ge lO E OM, SEE O ا‎ 
لمعه‎ eC E ORMAE GS) f 


MIE eS ILE  UEIAMAECMEeE Ma ECM (OES 
int deleteRecord = -1; 
iE (EOSULE — CHOICE STUDENT TABLE) { 


SQLiteDatabase db = 
helper.getWritableDatabase )( م‎ 

deleteRecord = 
dB dele e OS OEE CHE LEE SU DENT تاش‎ 7 Sele E Om, 
Sê LEE E1 اك جره‎ 129 5 


EMIS. 06 6 93512 52226 )( : و‎ 2 54611 ECR ERE SO Ive () MOEA f جاتر‎ 219 ) 
مغن متنا‎ E 
| شه عه للع‎ (EES E SS CHOMGCE تاس ناشت‎ [0 EECORD) 
SQLiteDatabase db = 
helper.getWritableDatabase )( م‎ 
SEMO كلد‎ > UN : 6 عا 25 طلعات‎ EAE MS COMER E )١ 
deleteRecord = 
SO EEE E MS OEE EFE See SEU DEE RAE ارك‎ TA SC 
amd cele CEIOM, 51-26 6 ORA OS) 


ERS 0 0ت 2 6ت‎ ECE (J COS E COR ECRE RESO VEE OODLE VERSO E 
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دن 


U1 
OO 


O) 
O 


¥ ذت‎ 
WN N 


O 5 
© رك‎ 


O O 
فا‎ 0 


لى) ثن) ثن) ت ت (/) ا لن) ر كلم كلم كل كلم كلم کل کل كلم حلم خلر 
OBE CODD mm ©‏ ذت ل OSO OO‏ ك6 Ke‏ 


O O o GM ON ON On ON O 
ل ىا س حلم‎ O U١ حر‎ N حم‎ 


O) 
3ل‎ 
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MULL‏ سمتلن TOS‏ 
I18 }Jelse{‏ 
throw new IllegalArgumentException ("Invalid‏ 128 
O‏ 
} :74 
E return deleteRecord;‏ 
} 162 
5 
IS 6 077 5 6 16 2‏ 
1 دعن ESE (UE‏ ع 2ه O BUCE SEINE‏ 
تلطلتامه tTelturh‏ 5200 
} :51 
:52 
0751168 2 5585 
SE ETE EEO CEE O‏ ادس GME E (UE‏ 16ت 65ت 112ل SAE‏ 
SEEMS 21-6‏ :55 
1 ( مك221 عدن د SEEING‏ 51 هن ضكرت 1 تا عت ! 15د SERIM ll‏ 5 
(E)‏ 510 02 . صرت كلت 21156 عل 2 SE E e SME‏ 
Lf (result == GION GE _ 5103/17 ASEAN‏ :528 
9S SQLiteDatabase db =‏ 
helper.getReadableDatabase ();‏ :90 
return‏ :321 
OB OEY (MySOLI Eee Per: SUDAN RABE, PEON eC E1 OM,‏ 2 32 
مك212 2 عدك 5 الاك RONAS, MOY‏ عت كد SEO‏ 6 لل 5 SS‏ 
} :94 
TEE E UKE I MM J °‏ ;95 
EOS }‏ 
50 


98: @Override 
SOE EOE AME 561-622 UES UA, COMEECM EZA MES VALUES, 


UO SEO GE EEE OM, 

5ه صشكرهك اعت 1د OME SEIMEI ll‏ 

1 int result = uriMatcher.match (uri) ; 

OSE mE 1512566155 COGS N, 

104: iE (eS UNE —— CHOICE STUDENT TABLE) 

LOSS SQLiteDatabase db = 

106: helper.getWritableDatabase (); 

OE updatedRecord = 

NOSE EB. 8 46 8 (MyYSOL tee Pe f: SNAUDENE NABEEE, values, 
10998 SELE SEO, 5616 61 22ت‎ 8 
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NOE 

ME RAMEE )‏ ل ع 5 2 : () عت CT OC ECOME CSE (COC ECOMECNIE EES‏ لكلا 
EL, MULL) 8‏ 1293 

E | م5 1ك‎ ME (EEeSUlLE >> CAOLCE SAUDE RECORD) 

14: SQLiteDatabase db = 

15: helper.getWritableDatabase )( : 

() 59102106 5 طعا جاع 5 2 عات UI.‏ > كد SEEMS‏ 5 11 

1 1 updatedRecord = 

OE 12ت 13 :هلك‎ EE OSO EE EEE E SAUDER AEE a eS Tm 
O 5 2121850 AMO LT SECC ETOM, 56156 م ا‎ 
1202 
[12115 ENS OE ECOR ECE (EOE ECEOMEENERE SO VE E (ROS E VOR ARO E 
LZ2S UE, MLL) 2 
1238 }else{ 
124: throw new IllegalArgumentException ("Invalid 
ملل‎ 52 MEN 
120 / 
LANs return updatedRecord; 
1288 
1298} 


الثابت 41711101113 (أنظر سطر رقم 4 و5) يحدد المعرف الرئيس لمزود المحتوى (Content‏ 
Provider)‏ وهو : "edu.ucas.sqlite.contentprovider.StudentProvider.یم‏ ". لاحظ أن مزود المحتوى 
)€Content Provider)‏ يستخدم كائن من الفئة ٥م MySQL te٥1‏ (أنظر سطر رقم 3 و15) والتي تم إنشاؤها 
في تمرين 6-2 للوصول إلى قاعدة البيانات من خلاله. لاحظ أنه من خلال الدالة onCreate()‏ (أنظر الأسطر من 
4 إلى 25) تم إنشاء الكائن من نوع 1ءم1 747500116116 وتمرير اسم قاعدة البيانات» 501060606 ورقم 
إصدارها 1. 


قبل شرح الكود الذي يجب كتابته في دوال مزود المحتوى (218071061 غ008462)» يجب التوضيح أن التطبيق 
الزبون 011606 يقوم بإرسال المعرف 0۸1 الخاص بالمحتوى الذي يريد الوصول إليه للتعديل أو الحذف أو 
الإضافة. لذلك فإن الدوال 105616 ,1100366 ,عtعاعd‏ ,لإ#عنان كلها تحتاج إلى مدخل 1711 يحدد المحتوى المراد 
تنفيذ الإجراء عليه. لاحظ أن المحتوى المراد الوصول إليه قد يكون الجدول كاملاً أو سطر معين في الجدول. لذلك 
يجب أن يقوم مزود المحتوى بترجمة وتحليل معرف المحتوى 111:1 ءاه لمعرفة ما إذا كان يشير إلى جدول 
أو سطر محدد في الجدولء وللقيام بذلك نستعين بكائن من نوع 17113130161 (أنظر سطر رقم 7 و8) والذي نقوم 
من خلاله بتحديد الصيغ المختلفة لمعرف المحتوى 171:1 والقيم التي يتم إرجاعها مع كل صياغة (أنظر الأسطر من 
8 إلى 22). مزود المحتوى الخاص بنا يتعامل مع صيغتين لمعرف المحتوى 17191 Conte)‏ هما: 


٠ه conten t:// > A UY THORITY><TABLE_NAME>‏ (معرف مزود المحتوى متبوعاً باسم الجدول) 
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«ه content://S<SAUTHORITY > <TABLE_NAME>/#‏ (معرف مزود المحتوى متبوعا باسم الجدول 


عند تمرير أي قيمة معرف محتوى R1‏ ل )معء)ده') من خلال الدالة query‏ مثلاًء يتم مطابقة القيمة الواردة 
بالصيغ الموجودة في 1111312611 وعند تطابقها مع أي صيغة تقوم بإرجاع رقم يدل على الصيغة المطابقة. 
فمثلاً اذا تم تمرير المعرف التالي 0R]‏ غمع)مه©: 


content://ps.edu.ucas.sqlite.contentprovider.studentprovider/Student 

يقوم UriMatcher‏ بإرجاع القيمة CHOICE_STUDENT_TABLE‏ 
بينما إذا تم تمرير المعرف التالي 101+1] غ014 0©: 

content://ps.edu.ucas.sqlite.contentprovider.studentprovider/Student/5 
CHOICE_STUDENT_RECORD بإرجاع القيمة‎ UriMatcher يقوم‎ 
حيث أن طريقة تنفيذ الإجراء المطلوب على قاعدة البيانات يعتمد على قيمة المطابقة المرجعة من ,عداء]111/12[]آ.‎ 
سنتطرق الآن إلى الكود الذي سيتم كتابته في بعض دوال مزود المحتوى:‎ 
في الدالة ()61وم1 (أنظر الأسطر من 28 إلى 45) نقوم بكتابة الكود لتنفيذ الخطوات التالية:‎ 


1. استخدام ۲مطءt r1 Ma‏ لتحديد نوع 17121 ما إذا كان يشير إلى الجدول أو إلى سطر في الجدول.في المثال 
الحالي سنتعامل مع 171:1 الخاص بالجدول فقط (الأسطر من 29 إلى 31). 


2. رمي استثناءم0)معع8:2 إذا كان 17101 غير صالح (الأسطر من 39 إلى 42). 


3. الحصول على مؤشر من نوع 5011612330356 قابل للكتابة عن طريق الدالة 
getWritableDatabase)‏ (سطر 32 و33). 


4. إجراء عملية ,1256165001 لإدراج البيانات الموجودة ضمن 002162117731065) في جدول قاعدة البيانات 
(الأسطر 34 و35). 


5. إخطار مستخرج المحتوى 000066011650177 بالتعديل الذي تم عن طريق تنفيذ الدالة 
notifyChangeO0‏ (سطر 37 و38). 


6. إعادة معرف محتوى 1111 002666 يمثل سطر الجدول المضاف حديثاً (سطر رقم 43 و44). 
في الدالة ()رعںي (أنظر الأسطر من 84 إلى 96) نقوم بكتابة كود لتنفيذ الخطوات التالية: 


1. استخدام :وطن17113 لتحديد نوع 11121 ما إذا كان يشير إلى الجدول أو إلى سطر في الجدول.في المثال 
الحالي سنتعامل مع 01 الخاص بالجدول فقط (الأسطر 87 و88). 
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2. الحصول على مؤشر من نوع 5011612230356 قابل للقراءة فقط عن طريق الدالة 
getReadableDatabase)‏ (سطر رقم 89 و90). 


3. تنفيذ الاستعلاء باستخدام المدخلات الأخرى للدالة ()10عنان ومن ثم إرجاع الناتج مغلفاً بكائن من نوع 
Cursor‏ (سطر رقم 92 و93). 


لاحظ في الدالة ()03]6م1 (أنظر الأسطر من 99 إلى 129) يتم تحديد نوع 01 والتعامل مع كل نوع بتنفيذ 
التعليمة ع1100126 .501 المناسبة. فإذا كان معرف المحتوى (111:1 06ع002]6) يشير إلى الجدول في قاعدة 
البيانات (يتم فحص هذا الشرط في سطر رقم 104)» فمن المفترض أن شرط التعديل (جملة )WH ER۴‏ »والذي 
يحدد الأسطر التي يتم التعديل عليها »موجود في المتغير 10]ع16ه5: أما إذا كان معرف المحتوى يشير إلى سطر 
معين» فيتم اضافة رقم الصف 11 إلى الجملة رمام [مء لتكون ضمن جملة W1٤٤‏ (أنظر الأسطر من 116 
إلى 119). الدالة ()ع]ع1ء0 (أنظر الأسطر من 48 إلى 76) تقوم بنفس الإجراء وتنفذ تعليمة 106166 .501 بناء 
على نوع معرف المحتوى. 


بعد إنشاء الفئة StudentProvider‏ الخاصة بمزود المحتوى» تخب الإعلان عن مزود المحتوى في ملف 
Manifest‏ كالتالي: 


<provider android:name=" 

BS ECSU 0525-5 ١ 5 156ل‎ COM ECREDE SV GEE SE 1 عت 1ت‎ EEE ات‎ 
SEE SMO AE MOE 11 Me Sl 

PS EGU UCAS SII 63 COM 2 دن © عكر عا كت‎ SEE. د‎ 6 11621 6 210 11 E 
android:exported="true"/> 


بعد ذلك يصبح مزود المحتوى 56010651011061 جاهزاً للاستخدام من أي تطبيق آخر» حيث يمكن الوصول إليه 
من خلال المعرف 081 الكالي: 


content:// ps.edu.ucas.sqlite.contentprovider.StudentProvider 
ومن ثم إلحاق اسم الجدول والسطر المراد الوصول إليه.‎ 


بعد توضيح خطوات إنشاء مزود المحتوى (210171061 0026606)) سنقوم بإنشاء تطبيق جديد للوصول لمزود 
المحتوى واستخدامه. التطبيق الجديد سيكون له نفس واجهات تطبيق قواعد البيانات الموضح بالشكل» ويقوم بنفس 
الوظائف: وهي عرض اتات الطلاب: والإضافة والحذف» مع أختلاف واحد وهو الوصول إلى قاعدة البياناتك عن 
بعد من خلال مزود المحتوى 500106112101101 الذي تم إنشاؤه. 

التطبيق الجديد لن يقوم باستخدام كائن من نوع SQLite Open Helper‏ بل فقط كائن نوع ContentResolver‏ 
للوصول لقاعدة بيانات التطبيق البعيد من خلال مزود المحتوى 207107 غ002662). التطبيق الجديد يستخدم الفئة 
0811011107 لتنظيم الوصول لمزود المحتوى وإخفاء تفاصيل الاتصال والاستعلام. الفئة 
Student BU jlity‏ مشابهة بتلك المستخدمة في تطبيق قواعد البيانات - تمرين 6-2» باستثناء أنها هنا تستخدم 
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كائن من نوع 002162419650171 بدلاً من .SQLiteOpenHelper‏ الكود الخاص بالفئة StudentDB Utility‏ 
الجديدة موضح فيما يلي: 


PUC INE CESS SEU COME DEU ES لك ل‎ 2 7 


ContentResolver resolver; 

BEBE SEAS 2211م‎ SENS LUO 
"content://ps.edu.ucas.sqlite.studentprovider. 
SE 161 ع ات‎ 6 EEE 

BME ME 5626216 Ema 3 SM UDENT ERODE UT 
UE Pa ESE AURORE I SEEGER 

BBE SEA EE EMSAL SEER GS ELLES > 

{7 AO, mame” , age” js 


< )© GO IAS حنم إرث‎ GOSS |: 


BUS ME 6 016 ع ضع كت‎ UE SIRE ) 2 6222 12ت‎ COM EEE SED 
resolver = context.getContentResolver )( ; 


} 


BUC LAE WEN 121 مرحت‎ ES EUGENE (SERIN mame, CME 260 6 
ContentValues values = new ContentValues )( م‎ 
values.put ("name", name); 
values.put ("age", age); 

Fe EUERN KesOlve E. iM set E (SRA UDENTE EROVIDER URT, 
values); 


} 


Old SO حجر ين‎ UNH امه هه وم 6ه تت‎ oe هه هه‎ oe we 


| شم كم كم هم كم كخم هخم هخم كم N N N‏ 
ms DT RS!‏ 


N 
دن‎ 


N N‏ ذخا وخ UUW WNN‏ (ب) (ب) لب) لب) لي) 
حل رن ذلك لھ 62 فا © )١5 |] ٠‏ 0 كلم لزنه ١ت‏ لد 


ES )( !‏ 7ك ك1 ع 5 !1 للك عات هن 627 ع كت 6 05> 6 5 11 ك 1د لل ولناركر 
List<Student> students = new‏ 
Ara VLA SECS EUAeEREZ> (J;‏ 
CIES OE CUE SOE —‏ 
RE SO e: GUE EY (SUDE 12567111215 UE ALESIS, AO,‏ 
mame‏ 
SESI MM OCR EES EE‏ 
١‏ ( () 2516 طعت 6 wa NE (EULESS MSA‏ 
IME ) 0‏ عات 6 2 12ت 5 لمات = mE O‏ 
12 ) كلد GEES EE‏ عدت 5 مزلت > SEEING mame‏ 
int age = cursor.getInt (2);‏ 
Student s = new Student (id, name, age);‏ 
students.add(s);‏ 
cursor.moveToNext ();‏ 
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E }‏ 
cursor.close();‏ :39 
return students;‏ :40 
} 41 
:42 
public long deleteStudent (int id) 1‏ :43 
EE E UEM Fe Solver Ge le Ee (SEUDENE EROMIDER UR To‏ 44 
RO VANE OE (DDE‏ عد عت ) || عع 5 217 شاد 0-5 داك 
} 46 
Not used for contentprovider‏ // :47 
_BUblIICE 70214 Open () )[‏ :48 
Not used for contentprovider‏ // :49 
() كلت UO‏ 5111م :50 
} 2 511 


لاحظ أنه في الباني 025]10101©) الخاصة بالفئة '56010641(11[0011697 (أنظر سطر رقم 12)» يتم الوصول 
للكائن من نوع :001611965015 والمتوفر في )2زع]02ح من خلال تنفيذ الأمر التالي: 


resolver = context.getContentResolver )( , 


الدوال الأخرى مثل insertStudentO +«getA11Students()‏ و eteStudent0اهل‏ مطابقة لتلك الموجودة في 
التطبيق السابق» باستثناء استخدام مستخرج المحتوى (Content Resolver)‏ لتنفيذ الإجراء المطلوب على قاعدة 
البيانات هن خلال مزود اتشرف 


بعد إنشاء :561062108111117 يمكن استخدام نفس كود الفعاليات (4001516165) وتصميماتها الموجودة في 
التطبيق السابق دون أي تغيير» ومن المفترض أن يعمل التطبيق تماما مثل التطبيق السابق باستثاء أن قاعدة البيانات 
موجودة في تطبيق آخر. 


أسئلة على الوحدة السابعة 


م 


ما الفائدة من إنشاء واستخدام مزود المحتوى Provider)‏ Content(؟‏ 
أذكر الدوال التي يجب كتابتها عند إنشاء مزود محتوى جديد؟ 
كيف يتم تسجيل مزود المحتوى في ملف الوثيقة (3/12116516)؟ 


قم بالتعديل على تمرين 7-1 وذلك بإضافة فعالية جديدة للبحث عن بيانات طالب من خلال مزود 
المحتوى (21011061 20012664)) ومن ثم عرض النتائج على الشاشة. 


د ضأ لد 
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رقم المقرر 
الوحدة الثامنة: 
مستقبلات النشر 
(Broadcast Receivers)‏ 
يتعلم الطالب في هذه الوحدة: 


”7 مفهوم مستقبل النشر (عv¡عcع‌R ٥225)‏ 8) واستخداماته. 

> إنشاء مستقبلات نشر (8910300256) للاستماع والاستجابة لأحدات النظام المختلفة 

7 تهيئة التطبيقات لنشر (817020256) رسائل إلى مستقبلات النشر الموجودة ضمن تطبيقات أخرى. 
”ا مفهوم الإشعارات (7101112261005) واستخداماتها. 


لدراسة هذه الوحدة لابد من الإلمام بمفهوم الهدف (٤مع)ہ1(‏ وأنواعه. واستخدامه للتواصل بين الفعاليات (إرجع إلى 
الوحدة الرابعة). 


Broadcast Receiver‏ أو مستقبل النشر هو مكون من مكونات تطبيق أندرويد يستخدم للاستماع للأحداث 
(Events)‏ الصادرة من النظام أو من تطبيقات أخرى. عندما يحصل حدث معين» يقوم النظام» أو تطبيق آخر»› 
بارسال رسائل من نوع (126626) وذلك لإشعار كل مستقبلات النشر (sإعv¡عءRe as‏ dههإ8)‏ التي تستمع لهذا 
الحدث. 


قرم مسبلات النشر جدورها يتتفيذ إجراء مين عفد حصول الحدث المع لم على سيل المقال» يمك إتشداء 

مستقبل نشر (1761ع1060 8170200356) للاستماع لحدث إعادة تشغيل الجهاز (8001) أو الحصول على إشارة 
الاتصال بالانترنت. عند حصول أي من هذه الأحداث يقوم النظام تلقائياً بنشر (6+02025) رسالة من نوع 
(4مع)م1) وذلك لإشعار مستقبل النشر (171عع106 82020354) بذلك والذي يقوم بدوره بتنفيذ إجراء معين مثل 
تشغيل تطبيق ما أو استئناف تحميل ملف من الانترنت أو إرسال إشعار (710156364050) بالحدث للمستخدم. 

مستقبل النشر (61 1066617 81020256) هومجرد "بوابة" للمكونات الأخرى ويهدف إلى القيام بكمية ضئيلة جدا 

من العمل. على سبيل المثال » بدء خدمة (917106) لأداء بعض الأعمال على أساس هذاالحدث. 


هناك خطوتان لتفعيل مستقبل النشر (Broadcast Receiver)‏ لاستماع للرسائل الصادرة من النظام وهما: 


1. إنشاء مستقبل النشر: وهذا يتم بإنشاء فئة متفر عة (1255ع506) من الفئة ›Broadcasi Receive‏ وكتابة الدالة 
(1760ع021260 وفيها يحدد الإجراء الذي يتم تنفيذه عند استقبال رسالة من نوع (1066726) والتي تفيد بحصول 
حدث معين. المثال التالي يوضح طريقة إنشاء مستقبل نشر يقوم تلقائياً بتشغيل فعالية (/4.01716) معينة» مثل 
متصفح الإنترنت» عند استقبال رسالة )Intent)‏ من النظام. 
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public class MyReceiver extends BroadcastReceiver 1‏ 
@GOverride‏ 
MECRE)‏ عالست 8 الك BOLE VOCE OME € CEE (COR ECE COMES‏ 
Mew IMEC > Mev MEE IE (IMEC RIE 2O EO TEND 7‏ 1205م مال 
Rew REemME . SE EDa Ea (UF ١ 5212-56 (LBEEPD : / / 00 711223-5-004: PSL),‏ 
(Mew LR EEN E) J,‏ 217 لك لك عات شع عدت 5 5 : 6 :2 62 SON‏ 
/ 
/ 
لاحظ أن المتغير (10:656) يمثل الرسالة التي تم نشرها من النظام» حيث يتم استقباله كمدخل للدالة 
()17ععع1م0.» بينما المتغير (061910166726) يتم إنشاؤه لتنفيذ الإجراء المطلوب بعد استقبال رسالة النظام 
وهو في المثال السابق تشغيل فعالية. 


2. تسجيل مستقبل النشر: بعد إنشاء مستقبل النشر كمكون لتطبيق أندرويدء لا بد من تسجليه في ملف الوثيقة 
(656]نطة8) التابع للتطبيق وتحديد نوع الحدث الذي يستمع لها. فمثلاً» اذا اردنا لمستقبل النشر المنشأ في 
المثال السابق الاستماع لحدث تشغيل الجهاز والمسمى )(ACTI[ON_BOOT_COMPLETED)‏ بحيث 
يتم إشعاره تلقائياً من قبل النظام عند حصول هذا الحدث» يجب إضافة الخاصية إع۷إعءم] داخل الخاصية 
application‏ من ملف الوثيقة ]71211165 كما هو موضح: 


> 3950-1162 EON 


<receiver android:name="MyReceiver"> 

EE MER 101 53162 

رت 2 2-3 

Em EE 8 AGEN OR BOO COME EERE >‏ لك 1ك تدك اسك MG mame ٠‏ 2 تلك للك 
SVaACELORM‏ 

</intent-filter> 

</receiver> 


</application> 
.0۸Reءءعز۷ع)( عند اكتمال تشغيل الجهاز» سيتم تلقائياً اشعار مستقبل النشر م 1۷ع ءءMyR ومن ثم تنفيذ الدالة‎ 


لاحظ أن تسجيل مستقبل النشر يتضمن تحديد مرشح الهدف ۴1٤ ٥۲(‏ 10660+6) والذي يحدد نوع الرسائل التي يستمع 
لها مستقبل النشر. في المثال الموضح» تم إعداد مستقبل النشر للاستماع لحدث إعادة التشغيل المحدد بالقيمة 
"droid.intent.action.BOOT_COMPLETEDمه".‏ عند إعادة التشغيل يقوم النظام تلقائياً ببث رسائل تفيد 
بحصول حدث التشغيل» حيث يتم استقبال هذه الرسائل من قبل مستقبلات النشر المسجلة لاستماع لهذا الحدث فقط, 


ملاحظة: بعض الأحداث يتطلب الاستماع لها إضافة إذن (00زوندممء2) إلى ملف الوثيقة (1465)0م8]0). فمثلاًء 
للاستماع لحدث اكتمال تشغيل الجهاز لابد من إضافة الإذن التالي: 
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> 115 © 5 ©م-‎ 22115 5 102 
android:name="android.permission. RECEIVE_BOOT COMPLETED"/> 


هناك عدد من الأحداث (Event)‏ الصادرة من قبل نظام أندرويد ويمكن الاستماع لها من خلال تسجيل مستقبلات 
النشر. يوضح الجدول التالي بعض أحداث النظام وأسمائها الثابته. 


جدول 8-1: بعض الأحداث (Events)‏ الخاصة بنظام أندرويد والتي يمكن الاستماع لها باستخدام مستقبلات 
النشر (Broadcast Receivers)‏ 


اسم الحدث وصف الحدث 
(102.18001_)0011215:111اء2. امع 01010.10 اكتمال إعادة تشغيل الجهاز 


android.net.conn. CONNECTIVITY _CHANGE‏ تغيير في حالة الاتصال 
بالإنترنت 


android .intent.action. A CTI[ON_POWER_CONNECTED‏ توصيل الشاحن بالجهاز 
android .intent.action. A CTION_POWER_DISCONNECTED‏ فك توصيل الشاحن بالجهاز 
android.intent.action. CALL‏ الاتصال بجهة اتصال 
android.intent.action.B A TTERY_LOW‏ انخفاض سعة البطارية 
android.intent.action. DAT E_CHANGED‏ تغيير في تاريخ ووقت الجهاز 


(ائManife).‏ يتم ذلك من خلال الدوال registerReceiye)‏ و .unregisterReceiver)‏ يفضل عادة تسجيل 
مستقبل النشر من خلال ملف ()و7/13011). 


تمرين عملي (8-1) 


يهدف هذا التمرين إلى إنشاء وتسجيل مستقبل نشر (196061761 189102002356) للاستماع لحدث من أحداث النظام 
ومق ك تف إجراء محدد عه حصول: هذا الحذك الكت الذي ديت الابشاع له عن تخر حال الاتضال بالشيكة 
ا (177111)» حين يصبح الجهاز متصلاً بشبكة (91/115:1) يقوم الجهاز بالاهتزاز (عاهإط¡۷) وعرض رسالة 
تبين أن الجهاز أصبح متصلا. 

الخطوة الأولي لتنفيذ هذا التمرين هي إنشاء الفئة (إعv My€onnectivityR eci‏ الخاصة بمستقبل النشر 
)Br0adcast Receiver)‏ وهي موضحة بالأسفل: 


1: public class MyConnectivityReceiver extends 
2: BroadcastReceiver 1 
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@GOverride‏ :4 
BMS NE OME OMRE CEME (COME COME E, UMECME TREE)‏ 58 
O8‏ 
ConnectivityManager conMngr =‏ 2 
(ConnectivityManager)‏ :8 
SMS 531115516163 (COME ESE EO ITE GT SE BATE E‏ 678 د EOE ESE‏ 98 
OE NetworkInfo wifi =‏ 
GSE 6118 60112 IEE SCORE E Ea 267312 EEE 1111‏ 6011112 11-8 
CS )( ( |‏ عات 1205 E CE MSE‏ 2 
(VIDIO)‏ < 2ت 2 ركان تع 2ص 5لا 1 
م GE 58 1/8 8311158125168 (CON EEE 111181511 E)‏ 8328 5 6ر8 2 148 
ORT OE e )5 00‏ ع VOA‏ 0 
ECS EO MIEN‏ عت 27ت 9 حا ست 1O2 ROA SEMA KEME E (COME‏ 
MVE 15 56 LENGE TONE ESO )(‏ 
1 12 
} 1 
A02 J‏ 


لاحظ أنه في الدالة ()م1۷عءء٥‏ 8ه (أنظر الكود من سطر رقم 5 إلى 20)» والتي يتم تنفيذها تلقائياً عندما يستقبل 
مستقبل النشر (171ع81702062351186) رسالة هدف (10626) من النظام تفيد بتغير حالة الاتصال بالشبكة» يتم 
استخدام أحد خدمات نظام أندرويد وهي (ع0ع561571 001261191697)) لفحص حالة الشبكة (أنظر الأسطر من 7 إلى 
9. إذا أصبح الجهاز متصلاً يتم استخدام خدمة أخرى من خدمات النظام وهي (عع56101 171613]01) لتقوم بعمل 
اهتزاز لنصف ثانية. أخيراًء يتم طباعة رسالة لتبين أن الجهاز أصبح متصلاً (أنظر الأسطر من 12 إلى 18). 


الخطوة التالية هي تسجيل مستقبل النشر في ملف (81316656) وتحديد الأحداث التي يستجيب لها. الشكل يوضح 
ملف الوثيقة (11651م213) الخاص بالتطبيق: 


SSR EE SOM N OL EME SRG > EE ارق‎ 
<manifest 
xmlns:android="http://schemas.android.com/apk/res/android" 
package="ps.edu.ucas.broadcastreceiver" 
ARG EON ك‎ ve ESN OMCOSSE >L 
android:versionName="1.0" > 
<uses-permission 
android:name="android.permission. ACCESS_NETWORK STATE" /> 
<uses-permission 
android:name="android.permission. ACCESS _ WIFI STATE" /> 
<uses-permission 
android:name="android.permission.VIBRATE" /> 
<uses-sdk 
android:minSdkVersion="8" 
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51201 610: تع‎ ESE ES Ak VERE S1 OM AN 

> 3851-16 ELO 
android:allowBackup="true" 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name" 
android: theme="@Gstyle/AppTheme" > 


<receiver android:name=".MyConnectivityReceiver™ 
android:enabled="true"> 
REE EE NEE 
<action 
android:name="android.net.conn. CONNECTIVITY _ CHANGE" /> 
</intent-=filter> 
</receiver> 


</application> 


لاحظ الجزء الأخير الخاص بتسجيل مستقبل النشر (إم۷إعءم۸ 870200356) حيث تم تحديد حدث النظام 
android .net.conn.CONNECTIVITY_CHANGE‏ للاستماع له. لاحظ أيضاً اضافة أذونات خاصة 
للاستماع لحالة الشبكة ولاستخدام الهزاز .(Vibrator)‏ 


قم بتشغيل التطبيق وتجربته وذلك بتغيير حالة الشبكة (۷1۴1) من إعدادات الجهاز وملاحظة ما يحدث. 
بث رسائل خاصة (Broadcasting Custom Intents)‏ 


يمكن تهيأت التطبيق الخاص بك لبث رسائل (10626) إلى تطبيقات أخرى أو إلى مكونات أخرى في نفس التطبيق. 
في هذه الحالة يتم بث رسالة (10]671) عن طريق تنفيذ أحدى الدوال الخاصة بذلك مثل الدالة ()56007310206251. 
الرسالة المرسلة يتم استقابلها من قبل مستقبلات النشر (175ع17عع16 82030356) المعدة لاستقبال نفس نوع 
(12]654) والمسجلة من قبل تطبيقات أخرى أو في نفس التطبيق. فمثلاً» قد ترغب في إنشاء تواصل بين تطبيق ما 
وأحد التطبيقات الأخرى على الجهاز. في هذه الحالة ما عليك إلا إنشاء وتسجيل مستقبل بث (Broadcast‏ 

R1۷ e1(‏ في البرنامج المستقبل» ثم تقوم بنشر رسالة (10]624) عن طريق البرنامج المرسل بحيث يوافق نوع 
الرسالة (Intent)‏ النوع المحدد في مرشح الهدف (Intent Filter)‏ لمستقبل النشر. يمكن استخدام هذه الطريقة 
للتواصل بين أجزاء التطبيق الواحد من الواجهة (4011717) وخدمة (ع960710) تعمل في الخلفية مثلاً. يوضح 
الكود التالي كيفية نشر رسالة عن طريق الدالة ()6+02025112]61 تنفذ عن النقر على زر: 


public void broadcastIntent (View view) { 

Intent intent =new Intent (); 

E CINE ١ 5 كت شكات‎ 621 OM (EBS EAU. UCAS. 15 126 2-6162 5 كعك م عا‎ VEE CUS ROM NRE 
0 : 

52 17 2ك‎ 160 20625 (ADECCO E) 
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لاستقبال هذه الرسالة من تطبيق آخرء لا بد من تسجيل مستقبل نشر في التطبيق المستقبل بحيث يوافق مرشح الهدف 
Fite)‏ غأمع]م1) نوع رسالة الهدف. الشكل يوضح تسجيل مستقبل النشر 1ع17ع7191960 المنشأ في المثال السابق 
لاستقبال الرسائل المرسلة من التطبيق في المثال السابق 


<application 


<receiver android:name="MyReceiver"> 
SEE IE E 111 6 عدت‎ 
<action 
تناك رات‎ ORG Same LOS EOE MEAS 2 15563 2612 015 E Relee et ل ل‎ OEE ER > 
JAC AOS 
> LEO E> EAL LEONE > 
SW EEG E VEE 


MAP 2ك لد لمم‎ EA OM 


ملاحظة: لبث رسائل (70ء]10) يمكن استخدام الدالة () broadcast1ntent‏ أو )( .broadcastStickyIntent‏ في 
الدالة الثانية» الرسالة التي يتم نشرها تبقى في النظام لفترة» مما يمكن التطبيقات التي تسجل مستقبل النشر برمجياً 


من استقبال الرسالة عندما تصبح جاهزةً لذلك. أي أن الدالة الثانية تستهدف التطبيقات التي تستمع متأخراً للرسائل 


تمرين عملي (8-2) 


سنقوم بتنفيذ تطبيق بسيط نقوم فيه بإنشاء مستقبل نشر لاعتراض رسالة هدف مرسلة من أحد التطبيقات. واجهة 
التطبيق موضحة بشكل 8-1» حيث تتكون من زر واحد (26ع]10 82020356)» عند النقر عليه يتم نشر رسالة 
بحدث (40)10) محدد. عند استقبال الرسالة من قبل أحد مستقبلات النشر (17615ععه1 ايه dه0إ8B)‏ يتم طباعة 
رسالة على الشاشة. إذا كان باستطاعتك تنفيذ استقبال الرسائل الخاصة باستخدام مستقبلات النشرء يمكنك بنفس 
الكيفية استقبال رسائل النظام. 
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5 Ee 


Broadcast Intent Broadcast Intent 


Intent Detected 


شكل 8-1: واجهة التطبيق الخاص بتمرين 8-21 
كود الفعالية الخاص بالتطبيق موضح في الأسفل: 
AE E EY‏ 5ت 6ت GE NEY‏ 5 21ت 25-5 للدت BOE‏ 


@GOverride 
public cvoid onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) م‎ 

SE EC SMI EM Ee (E 6 1 1 16ت‎ ACE Ey Ma HM) 


} 

BECO OAS E A CIS EOM MEE ENL‏ م 

(Vi eW Vi eW) !‏ 11ت 1116 E‏ 151905025 16و 16 1 تلاك 

Intent intent =new Intent )( م‎ 

mk EME SE EAE E OM (EBS ١ اكت‎ MEAS SOEOAGEAS 6 85 تت‎ EE CUS ROM 
م خا ال‎ 

sendBroadcast (intent) م‎ 


< e e ا‎ e كن إن‎ CU O | ل‎ 


٠:‏ 52 و ك] د إن کک 


350 
5 


لاحظ أنه عند النقر على زر "10606 18120300256" يتم إنشاء هدف مضمن (٤ہماہ]‏ tزcنامص])‏ ويتم تحديد 
حدث خاص باسم CUSTOM_INTENT"‏ .s.edu.ucas.broadcastreceiverم"‏ (یمکن اختيار أي اسم 


Tutorialspoint, http://www.tutorialspoint.com/android/android broadcast receivers.htm ' 
152 . صفحة‎ 
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للحدث بشرط أن لا يتكرر مع اسم حدث آخر). يتم نشر (8170300356) هذا الهدف باستخدام الدالة 
(56]8103068510 (أنظر الأسطر من 10 إلى 13) 


نقوم بعد ذلك بانشاء مستقبل النشر (1ه17عع126 8170200356) الذي من المفترض أن يستمع للحدث الخاص 
ويستجيب له بطباعة رسالة على الشاشة. الكود التالي يوضح الفئة (6157©1ع213701015]020411052156) الخاصة 
بذلك: 


BUBE لد نات قن 6 5 1176015 2-5-5 للكت‎ ORNRECE VEE CExXECRSS 
BroadcastReceiver { 
@GOverride 
DEO IM E VOM OME 5ت‎ CEME )4 0ت‎ 26225 COME SE, EMEC E 
iT E CRE) 

ROA SE CMa KEME 262 COM تك ع‎ SE, ٠ 115 6 E 

Deleted. , Oa ا عت‎ LENGIN TONE) Sho O 
/ 


] تخا ثن) كم رن OSO 662 IS‏ 


: 


وفي الخطوة الأخيرة يتم تسجيل مستقبل النشر (61 10606197 810200254) في ملف الوثيقة (أوم؟fزرج).‏ لاحظ أن 
اسم الحدث (Action)‏ المستخدم في مرشح الهدف (Intent Filter)‏ يطابق اسم الحدث الذي تم ارساله مسبقا 
ضمن الهدف (106626) باستخدام الدالة .se{Broadcast)(‏ 


<manifest 
xmlns:android="http://schemas.android.com/apk/res/android"™ 
package="ps.edu.ucas.customaction" 
SAREE SMO EE SM ORCS E >L 
android:versionName="1.0"> 

<uses-sdk 

android:minSdkVersion="8" 

SIOR S/S‏ عت 1ك 5 E‏ 65 2ت ع : لك 1ك تنك 7ت 

GEOL LES 6 
android:icon="@drawable/ic_launcher" 
android: label="@string/app_name" 
android: theme="@style/AppTheme"> 


<receiver android:name="MyCustomActionReceiver"> 
<intent-filter> 


SA CEMO 
10ت دك 1ت‎ mame OS ١ 641170 UCAS: 1ع 66 2 5 069 52 ذا‎ vier : CUSTOM ل‎ LZ 
> 6ق /ر‎ 802 
</intent=filter> 
</receiver> 
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(Notifications) الإشعارات‎ 


الكلية الجامعية للعلوم التطبيقية 


</application> 
</manifest> 


الإشعار (721012100) هي رسالة يمكن إظهارها للمستخدم خارج إطار واجهة التطبيق» بمعنى أنه يمكن للنظام 
إرسال إشعارات (710144631005) للمستخدم دون الحاجة إلى تشغيل تطبيق معين. عندما يقوم النظام بارسال 
اشعار (71016210) للمستخدم» مثل إعلام المستخدم بوصول رسالة ما 5345 أو اكتمال تحميل ملف من شبكة 
الإنترنت« يتم إظهار الإشعار (Notification)‏ كأيقو نة في منطقة الإشعارات (Notification Area)‏ (أنظر 
شكل 8-2 )» وعند النقر على أيقونة الإشعار يتم إظهار التفاصيل في درج الإشعارات (Notification Drawer)‏ 


(أنظر شكل 8-3). 


2 8 ام 7 


The Big Meeting 
4:15 - 5:15 PM 
Big Conference Room 


© mae 


New Google+ notifications 
Earl Liîbyrd: Added you back 


wv 


ba, EMAIL GUES. 


Sereenshot captured. 


PM 


Keep photos & videos backed.. 427 


Touch to get free private Storage on Google 


3 new messages 


kumlatar.swankatranami@gmail.com 


3 new messages 


(754) 263-8267, 456 


0 


الم 


6© Touch to view your screenshot 


6 
© 


6 


شكل 8-3: درج الأشعارات (Notification Drawer)‏ 
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إنشاء الإشعار (Notification)‏ 


لإنشاء إشعار (7101102102) يجب في البداية إنشاء كائن من نوع 710011103102.81111061 ومن خلاله يتم 
تة خصائص. الإشعان وو اجيقة والإجراء الذي نة غنه القر على الإشعان بعد تحديد هذه اللقصائصنء يكم إنشاء 
الكائن الخاص بالإشعار 7105626302 عن طريق تنفيذ الدالة .Notification.Builder. build)‏ لإرسال 
الإشعار»ء يتم تنفيذ الدالة .NotificationManager.notify()‏ 


الإشعار (02101562400) يجب أن يشتمل على الأقل على ما يليء والتي يتم تحديدها من خلال الكائن 
:Notification.Builder‏ 


ه أيقونة صغيرة 10١‏ 551311 يتم تحديدها عن طريق الدالة () ٠0ء2111‏ ؟)عء. 
ه عنوان 1116 يتم تحديده عن طريق الدالة ()ع1711أمعغممماء5. 
ه التفاصيل )زه 1»)11.» يتم تحديده عن طريق الدالة ()دء11مع]1ه00)]ء5. 


كل الإعدادات والخصائص الأخرى للإشعار (2101462608) هي إختيارية ويمكن التعرف على تفاصيلها 
بالاطلاع على تفاصيل الفئة .NNotificati0 1. Bui]‏ المثال التالي يوضح طريقة إنشاء إشعار (Notification)‏ 
وإرساله: 


OEE EAE OR E 5 12! عر حاكن‎ BUM GEE E MEW 

NOEL I لكت للد ع و ك‎ : BULGE E (OC مر كرك ع‎ 1 1122 E 1 5266012 22-6 DE 
U LEE, Se 6 6 كرت 26ت‎ 2 E Le (NewS عع‎ 2 

ted‏ 12ت 2 5 Ceremonies‏ 621-017 301013 1ت" ) 6 591111221 506127 52 Ider.‏ لذلا كل 
E e 6‏ 

Bun der. Se ESMA LITEM (RE 1ت 2 تنك‎ 116 Me TE UmMEeE REE); 
عا © ا‎ 11 HCA EH OM MOEA 2 122 651 OM > SUN IGeEE. 9121 )( 
NotificationManager manager = 
(NotificationManager) getSystemService ) 

UE © كدت 05 12ت‎ OL TET GATOR SEE TEED 

LÛLE MEMEO o MOELLEV (AC, AOELELCAE LOM) 7 


لاحظ أنه في البداية يتم إنشاء كائن من نوع (21014261002.8111061) (أنظر سطر رقم 1 و2) ومن ثم تحديد 
الخصائص الأساسية للإشعار بتنفيذ الدوال setSmallIcon( «setContentText0 «setContentTitle()‏ 
(أنظر الأسطر من 3 إلى 6). 

بعد تحديد خصائص الإشعار (210016200) من خلال ›Notification.Builder‏ يتم إنشاء كائن من نوع 
Notification‏ بتنفيذ الدالة ()11110ط.1ع11110 .710014260 (سطر رقم 7). 


® 065 2 e كذ لزنه‎ CO O | 


لإرسال الإشعار (7102105): يجب في البداية الوصول للكائن (61ع7100626001/1302) وهو أحد 
خدمات نظام أندرويد المتوفرة في الخلفية (الأسطر من 8 إلى 10)» ثم يتم إرسال الإشعار بتنفيذ الدالة 
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Notification Manager.notifyO‏ (سطر رقم 11). لاحظ أن الدالة (201490 يمرر لها بالإضافة للكائن من 
نوع (000هء2100) رقم معرف 4¡ يتم اختياره من قبل المستخدم. يمكن من خلال هذا المعرف الوصول 
للاشعار لاحقاً لتعديله أوحثفه: 


الإجراء المرتبط بالإشعار (Notification Action)‏ 


على الرغم من كونه اختيارياًء يمكن إضافة إجراء واحد أو أكثر للإشعار (2101603]400). فمثلاً» عند النقر على 
الإشعار المستلم» يمكن تشغيل فعالية (/إ420115716) لإظهار تفاصيل إضافية عن الإشعار. 


داخل الكائن من نوع (71011502102)؛ يتم تعريف الإجراء (41102) المراد تنفيذه عن طريق تعريف كائن من 
نوع غ10162) ع10لء) والذي يحتوي داخله على هدف (10]626) يحدد الإجراء المراد تنفيذه. بعد ذلك يتم تمرير 
الكائن من نوع الهدف المعلق ()مع)مآعمنلمء2) عند طريق الدالة ()6)مء06آ])مع1مه0)ء5 من خلال 
.Notification.Builder‏ 


المثال التالي يستكمل المثال السابق وذلك بإضافة حدث («مناءA)‏ للإشعار حيث يتم تشغيل الفعالية (رغزA)۷)‏ 
الخاصة بمتصفح الإنترنت لفتح صفحة الكلية الجامعية: 


Notification.Builder builder = new 
NOME 1 لكت لدع أو ك‎ ١ BUN 11 2ك‎ (OCEAPE ل‎ 11 22 E 1 526 12ت‎ 2226 (E 
SKE CEE جرم قي عه‎ ECEME E KE (INES 1ع‎ UCAS 
builder.setContentText ("Graduation ceremonies started 
fol UCAS, 
u 11 4 هرت‎ SEE SMa LEON EEA a E E e Ame MEE) 
MEE SEECE OM EC NE NEE O LCE KE EOE moe MEO 
mie en E Em Ecemi > MEW MM EEN E (ERIE لست‎ E AG TON TEN 
REME. SEE Dafa (WEN PARSE (AMEE E SR. UCAS EAD BSL), 
PendingIntent plIntent = 

Ee EA ا لجرك‎ CME OE 622 كت‎ 2 1 EY ) 0 2ت ل لكر م عات‎ EN 1ت 2ت‎ EEE OT 
مكنا ولد‎ 01| 8 

BW SEE, SE 6 4 كت 5 12 هت‎ E EN ECE (CER 2 عالت‎ 

NOES KEANE MONEE 126 10 > 1101-6636 لتقا‎ E 
NotificationManager manager = 

(NotificationManager) getSystemService ) 

6 كدت 65 12ت‎ O TET CARTON SEE TEED 

11201226 علدت‎ 2 MOEA VY (OES, MOEN عا‎ 122 16 LOR) 


OG SDS ]‏ كن إن ذه ل 5 ECE‏ 


66 7 O OM E COS RS ا 0 03 56 @ كأ‎ 0 0 


لإنشاء حدث («٥1)ءA)‏ وربطه بالإشعار («0ناهءاگاهN)‏ ءيتم إنشاء كائن من نوع (10:606) لتحديد الحدث 
(«0ذاA)‏ المراد تنفيذه وهو في المثال الموضح من نوع ( )۸٤C110N_۷ 18W‏ (أنظر سطر رقم 8) ويتم أيضاً 
تحديد عنوان موقع الويب المراد فتحه من خلال الدالة (02620لاء5 (أنظر سطر رقم 9. 
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بعد ذلك يتم إنشاء هدف معلق (262012517214606) والذي يمرر له كائن الهدف (1,ع)م1) الخاص بالإجراء المراد 
تنفيذه (أنظر الأسطر من 10 إلى 12). بعد ذلك يتم تمرير الكائن من نوع (]760128172]672©) للكائن 
)NNotification. Builder)‏ من خلال الدالة ()0مء]12[)مء)م 56600 (أنظر سطر رقم 13) 


يمكن فهم الهدف المعلق (PendingIntent)‏ على أنه رسالة موجهة للنظام لنطلب منه تشغيل إجراء محدد عند 
النقر على الإشعار 7201451630 عند وصوله. الإجراء الذي يتم تنفيذه محدد عن طريق الكائن ١106606‏ الذي 
ممرناه لكائن الهدف المعلق (PendingIntent)‏ أثناء إنشائه. أي أن الإجراء المحدد في الهدف المعلق 
)مع ]مآع مصنكمء0) ينفذ من قبل النظام ويكون معلقاً لحين النقر على الإشعار (710611103]100) المستلم. 


تمرين عملي (8-3) 


في هذا التمرين سنقوم ببناء تطبيق منبه بسيط يقوم بتنبيه المستخدم بعد وقت محدد ليقوم بتنفيذ بمتابعة آخر الأخبار 
على موقع الكلية الجامعية للعلوم التطبيقية. التنبيه يتم بإرسال إشعار (710141“3]100) عندما يحين الوقت المحددء 
وعند النقر على هذا الإشعار يتم فتح الموقع الإلكتروني للكلية الجامعية. 


واجهة التطبيق موضحة بشكل 8-4 حيث يقوم المستخدم بتحديد وقت الانتظار والذي بعد انقضائه يتم إرسال 
الإشعار .(Notification)‏ كما هو موضح يقوم المستخدم بإدخال وقت الانتظار بالدقائق والثواني» ثم يضغط على 
زر "5٥1 A14۲"‏ وذلك لتفعيل خدمة التنبيه. 


Simple Alarm 


Minutes 5 


Seconds: 30 


Set Alarm 


0 300 5عأنامام 5 10 لعانالعطءة دروام 
5 ه52 


شكل 8-4: واجهة التطبيق الخاص بتمرين 8-3 
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لبناء هذا التطبيق» نبدأ أولآً بعرض ملف التصميم الخاص بالفعالية (307107اع شط ئة3/1): 


EMU eS OMS NOL لكل هك كرت‎ - UE E 6 ده‎ 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/RelativeLayout1" 
android:layout_ width="match parent" 
ARE EOE SAMO E _ 158:61 Mies ma EE RM ae ME 
SME EOE 4 ON عا كت‎ SET OMS VE REESE 


<TextView 
android:id="@+id/tvAlarmTitle" 
اده قاممرة‎ E EOE GE MS AS COME CM E 
:14ت ترك لل‎ lavyoUE تت‎ ESS COMER El 
:1ك ترك للك‎ TaAVOUE a 1 15 AONE LOPS EEE 
:16ت تنك ات‎ LEVOUCE CORESEHOEAL ZORE ALSHE EO 
AEE EG ES VOUIE MESES RRO SS 
12ت‎ 012 OMA: 6 ع دك‎ S1 2-7 224L 
مزلت 11 2ت‎ OME : عات عكدت ع‎ Ye > BOLL 
android:text="Simple Alarm" /> 


<TextView 

android:id="@+id/tvMinutes" 

AIEEE EG لا‎ 210115 GE MS A COM EE E 
11ت تك لت‎ EA OIE 52ت 1ت‎ IES OOM ECEME 
MAES KE OE a TOME AE E ROP E E 
21615و ماممرة‎ LAVOE _ 1118116 مم0 2 ك5 16رو ناهر‎ 
17 1 0114 11706 Mar OMOEA 

AREA E ORG SA VOU E Ma 626 ALE E 2O 
andrEO1d: text Minutes: /> 


<TextView 
android: 1d-lCOrid/tvSeconds 
AREA EOE E 1565ل‎ GE MS EA COME EM E 
1ن نك للك‎ E laVOU E MeO MES ESAS COME Ell 
android:layout_alignLeft="@G+id/tvMinutes" 
android: layout_below="@+id/tvMinutes" 
AEE EGE A VOU MS ESERO SS SO 
android:text="Seconds:" /> 


IOI E ESE 


صفحة. 158 


الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


android:id="@+id/edMinutes" 

AME EOG ال‎ 25761315 GE MS ES COME EME 

ME O MES ESO COME CME‏ 2576135 ال 615 تممه 

android:layout_alignBaseline="@+id/tvMinutes" 

android:layout_ alignBottom="@G+id/tvMinutes" 

android:layout_toRightOf="@G+id/tvMinutes" 
android: inputType="number" 

android:ems="10" > 


<requestFocus /> 
> ,/ 1361112182682 


GIREN CLOSE 

android:id="@+id/edSeconds™" 

EE MS ESS COM EER E‏ 21165 1ل eG‏ ملك ات 

OG A OIE ME O IES ESS COM ECEME‏ مك رلك 

android:layout_alignBaseline="@+id/tvSeconds" 

" 410/67566060205" 311-02580100 11ه337 1 : 3202610 

android:layout_alignLeft="@+id/edMinutes" 
android: inputType="number" 

ARO ROG ems "10 م‎ 


> 8 1 1ن‎ 
android:id="@+id/setAlarmBtn" 
ادو قاممة‎ 618 E OE GE MS ES COME EME 
1ن تدك له‎ 4: lavyOoUu E Mer MES IWS CONECR EL 
android: layout_below="@+id/edSeconds" 
ARE EOE E AVON E CEME 1ت 2 ات 12 ترات مت‎ E aE 
تنك لت‎ 2 101 E HA VOUE Ma ESERO 4 Sl 
android:text="Set Alarm" /> 


</RelativeLayout> 
ملف الكود الخاص بالفعالية (31314115167) موضح بالأسفل:‎ 
BUCE CESS لك ل عات تدك‎ 6217 CXECRSS LOE N EY > 
@GOverride 
protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
36 2 COMIEE RD EVE E TEMO E EEE EY MEAN 


ل | E‏ نكن كل ره ©١‏ 
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1ه = 62ت 6 7 تك دك HOSE‏ الاح ناتس 0 
ERASE E MANE WEYS KEE ESMERE SG‏ :8 
final EditText secondsTxt = (EditText)‏ 9 
TOE ERTS E IMOVIE WE VIA (RTA. 24556122 SJ‏ 
ME. Button setAlarmBtn = (Button)‏ 
E EE GSE RSV EWEY LORE TE SEE A LA ETE ER)‏ 
setAlarmBtn.setOnClickListener (new‏ 18 
OnClickListener )( {‏ :14 
15 
@GOverride‏ 116 
ا LTS BUC IME VONO ORC LE ew‏ 
mE mU EES —‏ 1 
( () 2ك مدعت 3ع : () 6 (MANU EC SLE GE ERE‏ 21ل 2ك ط اك كز NOS TT RECIEE‏ 
— 5222-0 اسك 200 
EEE 1 (‏ 265 : () عا دك فاته : (SE COMES SESE‏ 521652016 : 16ت 1111536 2E‏ 
scheduleAlarm (minutes, seconds);‏ 22 
/ 23 
10 224 
J‏ 252 
208 
VONO SEMELE EM ) 1 25 MEME ECS IME SECO S f‏ 1ك 7ك 
long currentTime = new‏ 25 
م () GregorianCalendar )( .getTimeInMillis‏ 
long scheduleTime = currentTime +‏ 
Mm Ee SE CO2 1 000 SECON SS CE OOO,‏ 
Intent intentAlarm = new‏ 
eM E (ES EAU MEAS a LATRINES A GEO‏ 16 1 
AlarmManager alarmManager = (AlarmManager)‏ 


SEES YS EEMSE EVA CE (COMEEXE  AFARM SERVICE) ; 


alarmManager. set (AlarmManager. RTC WAKEUP, scheduleTime, 
لد ك جع‎ RO عا لظت عا جز‎ . GE 2ع‎ 19526062 5 E (ERI SU, AREER EALLA EM, 
Hema روم‎ IM EERE: 18 ككسلا‎ UEDA KE ع( كا‎ 


N‏ لى) ل( نت لم) لت لن لن لا لا ل 
ف O 065 OSE OGD BRB CO‏ 


خثر كن حكن كير 
كت کا دن 


Toast.makeText (this, "Alarm scheduled for "+‏ 
minutes +" minutes and "+ seconds +" seconds"‏ 
Toast. LENGTH LONG) .show();‏ 
/ 
ا مك 
لاحظ أنه عند النقر على زر "41310 غ96" يتم قراءة القيم المدخلة في عناصر الإدخال وتحويلها إلى قيم رقمية 


كما هو موضح: 
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mE 2055-5 > 

EOS EEE ODDS‏ عدت 1 عات كن : OAE SE UNE (MENU IEC SEE‏ ملت مت 6 جك 
ME 522 SI -‏ 
PAE SE NE ) 5 2 26160546 GE EME E )( CEOS ADO DD‏ ك0 ت 6 كركلا 


يتم بعد ذلك تنفيذ الدالة ۸1۳0ء ان لءطءء والتي يمرر لها قيمة الدقائق والثواني. في هذه الدالة يتم في البداية 
تحديد وقت التنبيه ويساوي الوقت الحالي مضافاً إليه مجموع الدقائق والثواني الدمخلة» وهو ما يتم من خلال هذين 


Long currentTime=new GregorianCalendar )( .getTimeInMillis(); 
long scheduleTime = currentTime + minutes*60*1000 + seconds 


E OOO 

لتفعيل خدمة التنبيه يتم استخدام أحد الخدمات المتوفرة في نظام أندرويد وهي خدمة مدير التنبيه صإهاA۸)‏ 

(213232867 والذي يمكن إعداده ليقوم بنشر هدف معين (1021626 67020035]6) عندما يحين وقت التنبيه. لتهيئة 

مدير التنبيه يتم إنشاء هدف مضمن (06ع12]6 icitامص])‏ باسم («رترج1[كغمءم1) وذلك ليتم نشره تلقائيا من قبل 
مدير التنبيه عندما يحين الوقت المحدد كالتالي: 


Intent intentAlarm = new 

mie en EES COU. UES ELA EMR SEE VY ALARM ACETONE 

اسم الحدث («0ز)ءA)‏ المستخدم هو اسم افتراضي خاص بالتطبيق. لاحقاً سيتم بناء مستقبل نشر هل04 8) 
e1(‏ 1ءء R‏ ليقوم باستقبال الهدف (1066726) المرسل بنفس الهدف المحدد. 


يتم بعد ذلك إعداد مدير التنبيه (61ع2/12228 ۲۳ها۸) بإنشاء هدف معلق (26201212]606) وذلك لنطلب منه 
نشر الهدف (intentAlarm)‏ عندما يحين الوقت المحدد وذلك من خلال الكود التالي: 


alarmManager. set (AlarmManager. RTC WAKEUP, scheduleTime, 
EERO ARO عا مك1‎ CME. ارطع كان‎ 26062516 ERA Sy TEER A LA EM, 
EEE سس مسرن‎ E ELAG UEDATE CURRED 


الخطوة التالية تتضمن إنشاء مستقبل نشر (10661976 90300256) ليقوم تلقائياً باستقبال الهدف المرسل من مدير 
التنبية ومن ثم إرسال الإشعار (200ع7106) إلى المستخدم. الكود التالي خاص بمستقبل نشر باسم 
:MyAlarmReceiver‏ 


public class MyAlarmReceiver extends BroadcastReceiver { 
116ل متام‎ 5625212 ma E 5ك‎ OSE TE NG AKON OD > م‎ 
@GOverride 


BUC LE UOMO OMERECE YE (COM EEE CON EOE, الك 2 لظا‎ AMEE E) 


1 


| ذا ف حنم ره OO EIS‏ 


NOE rea OM. BUA Ee Bu Ge 2 MEOW 
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O Nol MEA EN ORM EU IGE E ) 2ت 2 ضحت‎ 2 
OE DMSO SEECEOM EE MEME E AAEM Sem CGE 
11 DANSER SE 65106 EC MELEE Eme EO 55ت 5 !! 62ت‎ MEMS 
د شال‎ EEOM UO 
1 :سرت إن 1ك للك‎ SOCOM ات ا‎ (RK. 61ت نت مك‎ 5 LE 11 لت‎ f 
1 BUL GER. 52 6 6610 كلت 1 1ت ) 22س ع 2ك‎ FOE mone IMFO), 
15 Intent ucaslntent = new 
16 Intent 010 6 عت‎ AG TON VTE) 7 
E 1122-5 1 55 66 Se EDA Ea (UE BALES E (CREEPS 2 UV. MEAS 
1585 _ ced.) 8 
0 12616116 ع دس‎ EME 5ت 62 2ك‎ > 
AOE EEO NE CME OSE 2ت شت‎ N EY ) ,عدت 5 كت‎ OF Meas 6ت 2ل‎ O 
2: Bun I Ger ١ 52 2 6 0 17 5 عا لت‎ LM ECR E (PIR ECR E), 
2 NOE EE EAE رت‎ MONEE 1226 ابت 1ع‎ > ODUM كك مرك‎ E ) 
25 NotificationManager manager = 
24: (NotificationManager) context.getSystemService ) 
25 كه مره‎ 2515 OE TET CARTON ES EE TCE) 7 
26 111210267312 AO اتنا‎ 117 (CIO ET ENG AT ON ED OE E eae EO) 8 
2 } 
ا‎ 

وأخيراء لا ننسى تسجيل مستقبل النشر (1ه197ع119413117160) في ملف الوثيقة (6و7111) كما هو موضح: 
<receiver android:name=".MyAlarmReceiver"‏ 


android:enabled="true"> 
EEE SR NEE 
<action 
android:name="ps.edu.ucas.alarmnotify. ALARM ACTION" /> 
</intent-filter> 
</receiver> 


لاحظ أن اسم الحدث (م0]ع4) المحدد في مرشح الهدف (۲ع)۴1 ٤مم†م])‏ يطابق اسم الحدث الخاص بالهدف 
(عnt])‏ الذي يرسله مدير التنبيه .)(Alarm Manager)‏ 


قم بتشغيل التطبيق وتجربته بإدخال وقت الانتظار ثم انتظار وصول الإشعار .(Notification)‏ 
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أسئلة على الوحدة الثامنة 
ما فائدة مستقبل النشر (ءع17عع106 81702025]6)؟ وما الفرق بينه وبين الفعالية (107٠ناءل)؟‏ 
قم ببناء تطبيق يقوم تلقائياً بإرسال إشعار (Notification)‏ للمستخدم عند تغيير الوقت من إعدادات الهاتف. 


قم بالتعديل على تمرين 6-2 الخاص بقواعد البيانات وذلك بنشر رسالة (5620110206251) عند إضافة أو 
حذف بيانات أي طالب. قم بعد ذلك بإنشاء مستقبل نشر (1761عع186 ء4 )8٥2‏ لاستقبال هذه الرسائل 
وإرسال إشعار (Notification)‏ للمستخدم للإعلامه بالإجراء الذي تم تنفيذه على قاعدة بيانات الطلاب. 


ما الفرق بين الرسالة التي يتم طباعتها باستخدام غ1025' والإشعار Notification؟‏ 


ما الفرق بين Intent‏ و PendingIntent؟‏ 
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الوحدة التاسعة: 
تصميم الوجهات باستخدام القطع 
(User Interface Design by Using Fragments)‏ 
يتعلم الطالب في هذه الوحدة: 


”7 مفهوم القطع (ئا عص عه۴۲) واستخداماتها. 

> استخدام القطع (sأرعصعهإ۴)‏ لإنشاء تطبيقات موائمة تتكيف مع حجوم الأجهزة المختلفة وأوضاع 
العرض. 

دورة حياة القطعة (26عممع122) وعلاقتها بالفعالية المضيفة (رtزA)1۷).‏ 

طريقة إنشاء القطع (5]عدمع 22) وربطها بالفعاليات (1065كتناءه). 

التواصل وتبادل البيانات بين القطع (2)5ع7مع122). 

”و اتقامرات الخ ار( واوا النكلفة و يها 


القطعة (Fragment)‏ واستخداماتها 


< &K حك‎ 


القطعة (Fragment)‏ تمثل جزء من واجهة المستخدم المعروضة ضمن الفعالية «(Activity)‏ حيث يمكن تجميع 
ع لطم 07ع لكرين واحية راحدة رض في التعالية بالإضانة إلى كلك يكن امتخدام القطعة 
(4عممع 113) في أكثر من واجهة. 


يمكن استخدام القطع (Fragments)‏ وإعادة هيكلتها للتلاءم من أحجام الشاشات المختلفة .فمثلاً, شاشات الهواتف 
الصغيرة لا تتسع لعرض الكثير من المكونات» لذلك يتم عرض مكون واحد» على هيئة قطعة واحدة «Fragment‏ 
داخل واجهة الفعالية (/4]1716)» حيث من الممكن أن يشتمل التطبيق على عدة فعاليات (411510165) تعرض 
كل منها قطعة واحدة (]مورمع17:2) نظراً لعدم إمكانية عرض أكثر من قطعة لصغر مساحة الشاشة. أما في حالة 
الأجهزة اللوحيةء فمن الممكن تجميع أكثر من قطعة (172872606) في نفس الواجهة التي تتسع لعرض عدد أكبر 
من المكونات. في كلا الحالتين» يتم إعادة استخدام نفس القطع ولكن بترتيب وهيكلية ر القدرة على إعادة 
استخدام قطع الواجهة 11287576215 توفر الجهد والوقت اللازم في حالة إنشاء واجهة جديدة لكل جهاز مختلف 


كمثال عملي على استخدام القطع ]ج13 في تصميم الواجهات للأجهزة المختلفةء افترض ان هناك تطبيق 
يعرض قائمة من العناصرء وعند اختيار أي عنصر يتم عرض تفاصيله (مشابه لفكرة تطبيق إخباري). واجهة هذا 
البرنامج يمكن تقسيمها إلى قطعتين: قطعة 1 خاصة بعرض القائمة الرئيسية» وقطعة 2 لعرض تفاصيل أي عنصر 
يق الكار مهن القائمة, فى حالة الجياز. اللوحي» يفكن عرض كاذ التطعتية في نفس الواحهة حي تكسم السا 
لذلك. أما في حالة الهاتف ذي الشاشة الأصغرء فيتم عرض كل قطعة ()معرمع 2) في فعالية (/411530): حيث 
تحتوي الفعالية الأولى على قائمة العناصر (أنظر شكل 9-1). وعند النقر على أي عنصر في القائمة يتم عرض 
التفاصيل في فعالية جديدة تحل محل القائمة. لاحظ أن نفس القطع (یام م عه۴۲) تم استخدامها ولكن بترتيب 
ملف في کل اة 
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يمكن اعتبار أن القطعة (766مع1572) هي وحدة مستقلة بذاتها ولها دورة حياتها ويمكن إضافتها إلى أو حذفها من 
الفعالية(/019167)ى) أثناء تنفيذ التطبيق. القطعة (4معرمع12) يجب أن تكون مضمنة داخل فعالية (7كناعة)» 
أي أنه لا يمكن عرضها بدون (401197169). كذلك دورة حياة القطعة (4معرمع 12) تتأثر بشكل مباشر بدورة حياة 
الفعالية (/]011571). عن إيقاف أو تدمير الفعالية يتم إيقاف أو تدمير القطع المضمنة داخلها. 


شكل 9-1: استخدام القطع (1726136265) لمواءمة التطبيق مع حجوم الشاشات المختلفة 1 


اكل الق 615و اة فقط في مر اة واجية الستكف مع أن داك لمات اة ركن 
أيضا في مواءمة الواجهة مع اتجاه العرض لنفس الجهاز. فمثلآً يمكن تركيب الواجهة في الوضع الرأسي 7201216 
بشكل مختلف عن تركيبها في الوضع الأفقي 213001502376 حيث يتم استخدام نفس القطع ولكن بتركيب مختلف. 


إنشاء القطع (Fragments)‏ 


لإنشاء قطعة (2606مرع2) يجب إنشاء فئة جديدة متفر عة (50-1355) من الفئة 4عرمع2]0 أو أي فئة أخرى 
متفرعة منها مثل is۴ rage")‏ اء Dialog Fragment‏ وغيرها. الفئة الجديدة (01255) الخاصة بالقطعة 

ramen‏ تحتوي على عدد من دوال الاتصال الراجع (216]50015 ع1ع031103) شبيهة بتلك الموجودة في 
الفعالية )Activity(‏ مثل )onCreateء‏ )onStartء onSt0p0 ›onPause0‏ وغيرها من الدوال. عاد يتم 
كتابة بعض هذه الدوال لتحديد الإجراء المراد تنفيذه في كل مرحلة من دورة حياة القطعة .(Fragment)‏ شكل 9-2 


Tutorial on Fragments by Lars Vogel, http://www. vogella.com/tutorials/AndroidFragments/article.html ١ 
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يوضح الدوال التي يتم تنفيذها خلال دورة حياة القطعة «(Fragment)‏ وحالة الفعالية المضيفة. ونوضح فيما يلي 
أهم الدوال التي يحتاج المطور إلى كتابتها لتنفيذ بعض الإجراءات. 


Activity State Fragment Callbacks 
Created onAttach) 
onCreate() 
onCreateView() 
onActivityCreated() 
Started onStart() 
Resumed onResume() 
Paused onPause() 
Stopped onStop() 
Destroyed onDestroyView() 
onDestroy() 
onDetach() 


شكل 9-2: دورة حياة القطعة (©2701) )Fragmen{ ¡fe‏ وعلاقتها بالفعالية1 


Fragments, Android Developer, http://developer.android.com/guide/components/fragments.html ' 
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ه re10‏ ه: يتم تنفيذ هذه الدالة تلقائياً من قبل النظام عن إنشاء القطعة (٤٬عصعهإ۴)‏ وقبل عرضها. يتم 
عادة استخدام هذه الدالة لاسترجاع البيانات التي تم حفظها عند توقف القطعة (06ع0مع722). يمرر إلى هذه 
الدالة حزمة (Bundle)‏ والتي يتم منها استرجاع البيانات. لاحظ أنه في حالة استخدام القطع (Fragments)‏ 
لبناء الواجهة» فإن كل قطعة مسؤولة عن حفظ واسترجاع البيانات الخاصة بها. يجب أيضا الانتباه أن دورة 
حياة القطعة مرتبطة بحياة الفعالية: بمعنى توقف الفعالية يترتب عليه توقف القطعة مثلاً. 


ه CreateView)‏ nد:‏ يتم تنفيذ الدالة تلقائياً عندما يحين وقت إنشاء الواجهة الخاصة بالقطعة. عادةًء كل قطعة 
يكون لها ملف تصميم خاص (1230111.1501)؛ ومن خلال الدالة ()17161ع]3ع0200 يجب إنشاء واجهة 
القطعة عن طريق تنفيذ الدالة ()ع10413]7.101126» حيث يتم تحويل ملف الواجهة إلى كائن من نوع 5/16 
يحوي كل عناصر الواجهة الخاصة بالقطعة. الكود التالي يوضح مثال لتنفيذ الدالة ()7٠16/آ000162]6‏ حيث 
جه إشام اها الق و ازور ل رسا تعاضر ارا البو حوؤة دااكله. 


public View onCreateView (LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
View view = 
ne aE EBE 7 Ka EE EE EMO MIE E 12 OM ORE ESS SIE OME EVARE, 
container, false); 

BUL دم‎ BDuLton = (BUEEOD) 
e E MO 1 توت‎ 1 LENE 16 7 BECO 

DEE جلت‎ SE EOE MERA عت كت ع 5ت‎ (MEW MIEW. ONCE RM SEeENE LO 
GOverride 
11ت‎ 6202161 OR Cee 7 1 

// Do something 

)م 

return view; 


} 
لاحظ أنه يتم تمرير متغير من نوع م17)1011ء771 للدالة ()ع612م1. هذا المتغير يمثل الحاوية 00]21061© 
الخاصة بالفعالية المضيفة (411071]97) والتي سيتم فيها تجميع كل القطع (067265مع1722) لتكوين واجهة 
النهائية للفعالية. الدالة inflate)‏ تقوم بإنشاء واجهة القطعة (Fragment)‏ للتتلاءم مع إعدادات الحاوية 
.container‏ 
لاحظ أن الدالة ()101413]6 تقوم بإعادة الكائن 5/167 والذي يمثل الواجهة الخاصة بالقطعة كاملةً. بعد ذلك 
يمكن البحث عن أي عنصر داخل الكائن 7/167 لعمل إجراء معين. فمثل» يوضح الكود السابق كيف تم 
الوصول للزر الذي اسمه 161021 الموجود داخل واجهة القطعة )معرمعج2 باستخدام الدالة 
f View B y0‏ ومن ثم إضافة مستمع (15]6061.]) لتنفيذ إجراء ما عن النقر على الزر. 
يجب الانتباه أنه من خلال الدالة ()001623]67716097 لا يمكن الوصول والتعامل مع الفعالية (/15710]اعم) 
حيث أن إنشاءها لم يكتمل بعد. 
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ه Activity Created)‏ nه:‏ يتم تنفيذ هذه الدالة بعد ()0000623667/16077 وذلك عندما يكتمل إنشاء الفعالية 
.(Activity)‏ تكمن أهمية هذه أنه يمكن استخدامها لتنفيذ إي إجراءات تحتاج للكائن ×عcon›‏ أو الفعالية 
(ر٤زاA).‏ على سبيل المثال» إذا أردت تنفيذ الدالة 8140 سء1,4۷1؟ للوصول لأي عنصر واجهة في 
الفعالية (رز۸A)1)»ء‏ طباعة رسالة 10256 أو إنشاء مامه ل۸ خاض بقائمة العرض (w٥۷1ءز)»‏ يجب 
تنفيذ كل ذلك باستخدام الكائن غ6رع0ح أو الكائن را1۷ازعه. عند تنفيذ هذه الدالة» يمكن الوصول للفعالية من 
خلال الدالة (031900ناعش]ءع» ومن ثم يمكن تنفيذ كل الإجراءات السابقة.الكود التالي يوضح تطبيق الدالة 
on Activity Created)‏ حيث يتم فيها تعبئة قائمة (115]17/161) باستخدام المحول .Array Adapter‏ 


public void onActivityCreated (Bundle savedInstanceState) { 
super.onActivityCreated (savedInstanceState) ; 
String[] values = newString[] { "Android", "iPhone", 
MA OMSMOBM Le BLACKBERRY, MeO, USE, 
"Windows", "Max OS X", "Linux", "05/2" }; 
ArrayAdapter<String> adapter = new 
AE e A 2 61 5ت‎ GES E EINE (OS EACE LIE (DY 
16د هت شلك مك‎ 1 7 LAVOE. SOLS LISE COM 1, VALUES) f 

setListAdapter (adapter); 

} 


:onPause() ®‏ يتم تنفيذ هذه الدالة عند الإيقاف و للقطعة (Fragment)‏ حيث تكون القطعة مرئية ولكن 


تم حجبها جزئياً من قبل فعالية (Activity)‏ أخرى. ت تستخدم هذه الدالة في حفظ حالة القطعة أو بيانات أخرى 
قبل إيقاف أو إغلاق القطعة. كما ذكرنا مسبقاً في حالة الفعاليةء يفضل تنفيذ كود حفظ الحالة في هذه الدالة بدلاً 


عن الدالة «conStopO‏ حيث أن الدالة الأخيرة قد لا يتم تنفيذها من قبل النظام في بعد الأحيان» أما الدالة 
() 0223115 فيتم تنفيذها دائماً من عند ايقاف أو تدمير القطعة .(Fragment)‏ 


»ه ()طء3])كرمن: يتم تنفيذ هذه الدالة عند ربط القطعة ()معدمرع ج:]) بالفعالية (/410159716). من المهم الملاحظة 
أنه عند تنفيذ هذه الدالة لايكون إنشاء عناصر الواجهة الخاصة القطعة والفعالية قد اكتمل وبذلك لا يمكن 
الوصول إلى محتواهما من عناصر الواجهة. يتم استخدام هذه الدالة للحصول على مؤشر لكائن الفعالية 
(19؟ امه ): وهو ما يلزم في حالة التواصل بين القطعة و الفعالية. سيتم الحديث لاحقاً عن استخدام هذه 
للتواصل بين القطع (065ع70ع12). 

إضافة القطع إلى الفعالية 


في الخطوات السابقة تم شرح كيفية إنشاء الفعالية (2674مع72) والدوال التي نحتاج لتطبيقها عن الإنشاء أو أثناء 

عمل القطعة. الخطوة التالية هو إضافة القطعة داخل الواجهة الخاصة بالفعالية (Activity)‏ والذي يتم بإحدى 

طريقتين: 

1. إضافة القطع إلى الفعالية بطريقة ثابتة: يتم ذلك بإضافة خاصية من نوع أرعمصعهع؟ داخل ملف 133/016 
الخاص بالفعالية. يتم إضافة القطعة fragment‏ تماماً كما يتم إضافة أي عنصر واجهة آخر كما هو موضح 
بالمتال التالي. لاحظ أن الخاصية :3011010 تشير إلى المسار الكامل للفئة (class)‏ الخاصة بالقطعة 
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المضافة. لاحظ أيضاً أنه تم إعطاء کل قطعة (Fragment)‏ رقم معرف من خلال الخاصية 010:10 مما 
يتيح الوصول للقطعة برمجياً فيما بعد. 


ML هله مدعي‎ NOL ناتك همك كرت‎ > UE 6 د‎ 
<LinearLayoutxmlns:android="http://schemas.android.com/apk/ 
EES / AMEE LE 


S LE VOUE_WICEASVEALL Saet‏ :مامد 
ORG EA O E ME O ES E OA Ee E‏ مك لت 
android:baselineAligned="false"‏ 
android:orientation="horizontal">‏ 


af RAMEN E 

android:id="@+id/listFragment™ 

A YOUE E E SOS‏ 124 5 تك للك 

AMOEOLES LAVOE ل ا‎ 14 

ات 6 م MEME MES Ma EE RM‏ 12ت 1120 1 1ه قلت 10ت 
android:name="ps.edu.ucas. fragmentApp.MyListFragment"></fra‏ 
MEE.‏ 

<fragment 

android:id="@+id/detailFragment" 
GMCEOLCIE LE VOUE_ WAGERS OCI 

LAVOE WELARE‏ مام ادو قاممرة 

تتم Mal CM‏ 15ت Men‏ 257016 1ل :214 تدك لله 
fragmentApp.MyDetailFragment">‏ . 11235 . 011» . 5م android:name="‏ 
< 51230111 / > 


< 11232137011 / > 
2. إضافة القطع برمجياً أثناء التشغيل: إذا اردت التغيير في القطع 5]معرمرعج:7 أثناء تشغيل البرنامج» يمكن 
استخدام الدوال التي يوفرها Fragment Manager‏ والذي يمكن الوصول إليه من خلال الفعالية 
)Activity(‏ بتنفيذ الدالة .getFragmentMa nage)‏ يوفر Fragment Manager‏ دوال لإضافة وحذف 
واستبدال القطع(ء), ع عھ٣۴).‏ 
قبل تنفيذ ذلك برمجياًء لا بد من تحديد مكان أو قالب فارغ في واجهة الفعالية ليتم إضافة القطعة ()معدمع172) 
إليه أو حذفه منها. المثال بالأسفل يبين ملف الواجهة 1,39/006 الخاص بالفعالية حيث تم إضافة عنصرين 
1131161330105 فار غين» وکل منهما له معرف 20010101:101. سيتم لاحقأ تعديل محتوى هذين العنصرين 
بإضافة وحذف قطع (Fragmen†s(‏ وذلك باستخدام .FragmentManager‏ 


SS EE SO LN. OL د ا لكات هك لت‎ 
<LinearLayoutxmlns:android="http://schemas.android.com/apk/ 
EES / AMCEO LEY 
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الس 2ه OMG E Ma 70116 GE MS Male‏ تك لت 
ات 16د م لات 105 AOE ME HOMES‏ ان 1ه AMEE‏ 
ات 6ه 112 ع1 ماما > SO OER 6 2 2 OR‏ عات 101 كت 


<FrameLayout 

AMA FOG : 1 1ن‎ CE G/U SECON E AMRE E 

Ee E‏ 2ه E A OU E GE > MAEM‏ 11ت تلك لك 
> ته Met GOM E> IMAC‏ 65ت 11 1618 رو مامساة 


SEE ame Ha WOU jE 
android:id="@+id/detailscontainer" 
AARON SAMO E GEMS male RM ست 2 م‎ 
11ت مك الت‎ LE OWE MOLEC 2 الات‎ ACO E 
دري :ك1كك هت‎ E> LOSE م‎ 


</LinearLayout> 

بعد ذلك يتم تنفيذ الكود التالي من داخل الفعالية (من داخل الدالة ()000768]6 مثلاً) والذي يوضح كيفية إضافة 

قطع (5)معممع22) داخل القوالب من نوع 298006.آ[عمج. لاحظ مثلاً أن الدالة 

(02.2000 مع يمرر لها المعرف الخاص بالقالب (/8.10.1156600+2106) بالإضافة إلى الكائن 
الخاص بالقطعة .(MyListFragment)‏ 


FragmentManager fm = getFragmentManager )( م‎ 


الإضافة // 

FragmentTransaction ft = fm.beginTransaction () م‎ 
FE 5604 )1 IO. II SECOMES IRE, Mew 1:15 8 11-5 ERE 2-0216 (JJ, 
E E COMM E () F7 


استبدال / / 

TOR) OD,‏ 6ت 212052 ع 1 15560 OMe MERE AM SAC EON CE TM.‏ 1ه مراك 

ft E. Fel 2 63 (E. 1A. 11-5 6 عدت 112 ات 6 نمت‎ | Meu MYLISEEEASMeER E (J, 
TL COMIC, 


حذف // 

Fragment fragment = 

EME EDO EEA OMe RM E Ey LOE ) 121: 11 SE COME AMEE) 
FragmentTransaction ft = fm.beginTransaction () ; 
11 . remove (fragment) م‎ 

E Ee COMM Û () 7 
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يمكن أيضاً أن نفحص بر مجياً ما إذا كان الفعالية (Activity)‏ ت تحتوي على قطعة معينة (Fragment)‏ أم 
عمل التطبيق. يتم ذلك بالوصول للقطعة ]مع رمع 2 من خلال الدالة findFragmentByIdO‏ ضمن 0 0 


Fragment ومن ثم ننفذ الدالة (1510133:010040 والتي تتحقق ما إذا كانت القطعة‎ .۴ragment Manager 
معروضة أم لا. الكود التالي يوضح هذه العملية:‎ 
DetailFragment fragment = (DetailFragment) 


getFragmentManager )( .findFragmentById(R.id.detailscontainer 
J); 
iE (EEFaOmMeRE null | | 1T ؟ (() 12137911 5 1 . 2011212 عدم‎ 
// 15 316 هن‎ 

} 


التواصل بين القطع (2)5ع تمع 1”:2) 


قد تحتاج القطع (ارمدمعهإ۴) للتواصل فيما بينها لتبادل البيانات أو الأوامر. على سبيل المثال» عند اختيار خبر 
موجود في قائمة الأخبار ضمن قطعة ماء يتم عرض تفاصيل الخبر في قطعة أخرى. لتحقيق التواصل د 0 
يفضل أن لا يتم التواصل بين القطع (sارعءصعه۲إ۴)‏ مباشرة بل عن طريق الفعالية المضيفة (421157167). أي 
القطعة تقوم بتمرير أمر ما أو بيانات إلى الفعالية المضيفة «(Activity)‏ ومن ثم تقوم الفعالية بتمرير ما وصل 7 
إلى القطعة الهدف. شكل يوضح كيفية التواصل بين قطعتين (sأرعءصعهإ۴)‏ من خلال الفعالية المضيفة 
(Activity)‏ حيث تستقبل الفعالية أ د بيانات من القطعة الأولى» وتقوم من خلال ما يسمى بمدير القطع 
)Fragment Manager)‏ بالو صو ل إلى القطعة الثانية. مدير القطع )۴ragment Manager)‏ يمكن عن طريقه 
الوصول لأي قطعة «(Fragment)‏ كما يستخدم لإضافة أو حذف القطع برمجياً أثناء عمل التطبيق. 


Fragment 1 Fragment 2 


شكل 9-3: التواصل بين القطع (sأرء٫عهإ۴)‏ من خلال الفعالية المضيفة '(ر٤¡۸)|۷)‏ 


Simple Developer, http://simpledeveloper.com/how-to-communicate-between-fragments-and-activities Î 
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الكود التالي يوضح كيفية تهيئة القطعة (Fragment)‏ للتواصل مع الفعالية المضيفة: 
public class MyFragment extends Fragment {‏ 


private MyFragmentListener listener; 


@GOverride 
public View onCreateView (LayoutInflater inflater, 
ViewGroup container, 
Bundle savedInstanceState) { 
View view = 
Tf a E عرت‎ E n AE e (E EOI AOMORI AOE, 
container, false); 
EuUtEonN ورت نع انوت‎ = (EUETON)] 
eW E AMON EWEY أت‎ )1 TE BUEE ORL), 
button.setOnClickListener (new View.OnClickListener )( 


{ 
@GOverride 
5165لا وناك‎ UO ORCI CEK We WM ! 
// Inform the Listener 
listener.buttonClicked(); 
/ 
)م‎ 


2621211 View; 


/ 
انق ا/‎ ClaSS 262 2666-6 EO 6 EO EME FFAOMEME 
//changes should implement this listener 
public interface MyFragmentLlListener { 
ك1 ل وناك‎ vO CUE EOC EKE SO 
} 


@GOverride 

BOE OME OME OR ACE EY SCE E) 

5 015 عدت‎ ORAS كت 2 ) كلت ات ع‎ 212 E 

iE ) 36 621 EY 12-6 ملاظ 1 4:] 55612 12ت‎ 2010211 ELIS Eee) | 

listener = (MyFragmentListener) activity; 
ESEN 

EMRE له‎ mew Clas SCA 5 2 8546 1ك عا كرت‎ OM (ACE VT EV 2 6 9ل تدع 5ت‎ )( 

+ " Activity must implemenet 
MyFragmentLlListener"™) م‎ 
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| لم كم كم هم هخم كم هخم هم كم N N N‏ 
ين افق شر كيم 


N 
دن‎ 


N N‏ ذخا WW WNW WNN N N‏ (لن) (لب) (ىي) (ى) لي) 
کا آنا ذه کک 025 كا كت دک دک ذل کا كك ا 25 


:| نذا إن كن رثك ISS‏ 6 ©) د 


الكلية الجامعية للعلوم التطبيقية الع 
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E }‏ 
} 408 
4¢ 
@Override‏ :42 
]| () كلت 2 OMG OMDeEE‏ 1512م 7 4355 
م )( super.onDetach‏ :44 
A5: listener = null;‏ 
} 426 
A73‏ 


فيما يلي سنقوم بشرح الأجزاء الرئيسية من الكود السابق: لتنفيذ التواصل بين الواجهة (رزذاA)‏ والقطعة 
(m۸۲ه۴)‏ يجب أن يتم تعريف واجهة برمجية (عع106112) تمثل المستمع (1عمء]1.15]) الذي سوف يستمع 
لاي تغيير يحصل في القطعة Fragment‏ (انظر الأسطر من 26 إلى 28< وهو ما يتم في الجزء التالي من الكود: 


public interface MyFragmentLlListener {‏ 
OE‏ لمكت 4211 كت BUC INES OMS OEE E‏ 
1 
ومن ثم تقوم الفعالية بعمل ارمام للواجهة البرمجية (۲٥۸ع†s¡ .MyFragme n‏ يمكن لأي مكون من 
مكونات التطبيق الاستماع للتغييرات التي تحصل في القطعة (7626مع222) من خلال تطبيق (٤,ع_عImp1(‏ 
للواجهة البرمجية .)MyFragmentListener)‏ فائدة إنشاء الواجهة )MyFragmentListener)‏ هو إبقاء 
القطعة قابلة للاستخدام دون أو تكون معتمدة على فعالية محددة. 
بعد ذلك يتم تمرير الفعالية (41197167) إلى القطعة (غ0عدمع ج1) من خلال الدالة 100ء4٤‏ ۸۸ه وهو ما يتم أثناء 
إنشاء القطعة كما هو موضح بالكود السابق (أنظر الأسطر من 31 إلى 40). في الدالة (110ء8] رمه يتم الفحص ما 
إذا كانت الفعالية تطبق الواجهة البرمجية (061ع]1.15آ]0عممع3137113) عن طريق 105608206046 (تفحص ما إذا 
كانت الفعالية لها نفس نوع (21614115]6261ع713:173) (أنظر سطر 33). اذا تحقق ذلك» يتم حفظ موشر للفعالية 
في متغير باسم listener‏ من نوع :MyFragmentListener‏ 
ELAS EERE) 1‏ 29010211 2ك 117 2552 17ت ع iE )26 6210 11 617 ANS‏ 
listener = MyFragmentListener) activity;‏ 
} 
عن طريق الكائن عمع]115» والذي يمثل الفعالية المضيفة في هذه الحالة» يمكن تمرير الأوامر أو البيانات بتنفيذ أي 
من الدوال المعرفة في الواجهة البرمجية (1عمعایز ٤٣ص‏ عهإMy۴).‏ فمثلآء في الكود السابق يتم إعلام الفعالية 
(رازA)i)‏ عند النقر على الزر وذلك بتنفيذ الدالة ()0201101660]ناط (أنظر الأسطر من 14 إلى 23). 
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تمرين عملي (9-1) 


هذا التطبيق هو مثال متكامل يوضح استخدام القطع (1387167]5) لبناء تطبيق معلوماتي عن المدن الفلسطينية. 
المخرج النهائي للتطبيق موضح في شكل 9-4: في الوضع الأفقي 6م1,3020503»: يتم عرض قائمة بأسماء المدن 
الفلسطينية على يسار الشاشةء وعند النقر على أي عنوان تظهر معلومات عن المدينة في يمين الشاشة. في الوضع 
الرأسي 20:16 يتم عرض أسماء المدن في فعالية (/420]19011)» ومعلومات المدينة في فعالية جديدة. 


لتصميم هذا التطبيق باستخدام القطع ‘Fragments‏ سنقوم بانشاء قطعتين: واحدة لعرض أأشماء المدن والثانية 
لعرض معلومات كل مدينة. واجهتا التطبيق في الوضع الرأسي 701016 والأفقي 6م1,3220502 تستخدمان نفس 
القطع ولكن بترتيب مختلف: حيث أنه في الوضع الرأسي يتم استخدام كل قطعة 6)مرعرمع ج12 في فعالية منفصلة» 
بينما في الوضع الأفقي يتم جمع القطعتين 11202665 في نفس واجهة الفعالية (ر)إA)]v).‏ 


لاحظ أن التطبيق يتطلب تواصل بين القطع :Fragments‏ حيث أن اختيار اسم مدينة من خلال القطعة الأولى 
Fragment‏ يتطلب تعبئة القطعة الثانية )ممع 12 بمعلومات المدينة التي تم اختيارها. 


لبناء هذا التطبيق ننفذ الخطوات التالية. 
أولاً: انشاء ملفات الواجهة الخاصة بالقطع (ی ٥‏ ع۴۲۵) 
في المجلد layout‏ ننشئ الملفات التالية: 


e‏ ]ayout.xmا_stfragmentا:‏ وهو يمثل تصميم الواجهة الخاصة بالقائمة (11567/1617) التي تعرض 
أسماء المدن. هذا التصميم سيكون ضمن قطعة و احدة ۸٤(‏ عص :)۴٣ag‏ 


DEL wor S1OM=1 , OF EMCO MENE E د‎ 
<LinearLayout 
XMINS :andrO1A4A- IHEP ://Schemas ١ 2001-0 ا‎ 
ARA E ع الا كان اد د اناده‎ 11 AAA ME AE LAWO E 
AREA EON 41: EVO ME GE R> ma Ee RM Bae E 
1ك‎ 01 0120: 11557006 Men ORME> MaECERM Caen Ell 
لدت كلت 11ت‎ O 1 لزت 85 6 2 عا رت‎ VERE COA 


<ListView 
android:id="@+id/cityListView" 
ادتوقاممرة‎ 618 EOE UGE > Ema Ee MOA eM 
تدك لك‎ 5170: 112505016 Men GOMES WEA CONEERNEL > 
</ListView> 
</LinearLayout> 
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EFCC DOESN 
Jerusalem Area: 360 km2 
Gaza Population: 1,816,379 


Largest City: Gaza 
Ramallah 


Jenin 
سی ر‎ 
Nablus e 
r 
caz 
Tulkarm ممصو‎ 


Al-khalil aa 


Haifa er o Dug “تشمو‎ | MAP OF THE GAZA STRIP 
000 مسج سيم‎ RAFAH «مسدسية‎ 
3# . - 
Yafa 5 6 سس‎ 
© س‎ 
کے کے‎ 
Areeha = 


واجهات التطبيق الخاص بتمرين 9-1 في وضع العمل الرأسي (201:01:816): التطبيق مكون من قطعتين وكل 
قطعة تعرض في واجهة منفصلة 


Jerusalem Area: 360 km2 

Gaza Population: 1,816,379 
Largest City: Gaza 

Ramallah 

Jenin 

Nablus 


واجهة التطبيق الخاص بتمرين 9-1 في وضع العمل الأفقي (ءمدءءفمه]): التطبيق مكون من قطعتين يتم 
عرضهما معأ في نفس الواجهة 


شكل 9-4: واجهات وأوضاع العمل للتطبيق الخاص بتمرين 9-1 


16]3115138226_13/010].21: وهو يمثل الواجهة الخاصة بعرض معلومات المدينة التي يتم اختيارها 
من القائمة» وسيمثل أيضا قطعة واحدة (6)معرمع223). يتكون التصميم من عناصر عرض (1/1617]<ء1) 
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لعرض مساحة المدينة وعدد سكانها وأكبر تجمعاتهاء بالإضافة لعنصر عرض (/1732861/168) لعرض 
خارطة المدينة. 


Ml تله مدع‎ N OL رتك مك كرت‎ UE 6 د‎ 
> 1112© 3213570111 
xmlns:android="http://schemas.android.com/apk/res/android" 
AREA EOE SAMO E EOE MS male RM AEE E 
AEE OG A OME ME O MES MAE ست تم‎ 
SEE SMO OME MIE 2 2 MOR VE RENEE > 
<TextView 
android:id="@+id/tvArea" 
ARE EOE SAO E EGE MS ES COM EEN E 
AE EOC SAVIO E _ 1861© MES EO CON ECEME 
AM عذك‎ 2 1401 SMA VOUE Ma ESMERE O ll 
android:text="TextView" /> 
<TextView 
AMO EON لكام 1د د أن‎ 4211/6515 EA OM 
AE 621612 HAMO E EGE MS ES COM EEN E 
AREF OG SAMO E MeO ES ES COM EEN E 
am EEE GE A VOU E MS ESERO SS O 
AMR ات تك‎ GEESE > Mese > 
<TextView 
11ت 16ت‎ AO EFI EYLEKE SS ECA E 
31171 02114: la YOU E WAGE R> WES OOM EOME ll 
ARE EOE 5 ال‎ 5706 _ 1861© MES EA _ CON ECEME 
AM EEG SA VOU MSSM OA 
517101611 GA EE SE > Mex EVA eM lL > 
<ImageView 
android:id="@+id/ivMap" 
17ت‎ 01 02114: la yOUE Mid tE R> WES COM EERE 
تنك جلت‎ ORG AMO E EO ES ES CON EEN E 
AREA E 821612 ال‎ 76105 OE UTE V> مرق‎ E e 
ARAS ك‎ EE 6 5 Ze > L2 US 
AMOEOLES LAVOE _ 106116 “كمه 1 امن‎ 20E 
android:src="@drawable/ic_ launcher" 
/< 


> / 11232137011 < 


ثانياً: إنشاء الفئات (وعءوه1ء) الخاصة بالقطع ومع ممع م2 كالتالي: 


:MyDetailsFragment e‏ وتمثل الفئة (ءوهاء) الخاصة بالقطعة (73871606) التي تعرض معلومات 
المدينة التي يتم اختيارها من القائمة. 
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public class MyDetailsFragment extends Fragment { 


TextView tvArea; 
TextView tvPopulation; 
TextView tvLargestCity; 
ImageView ivMap; 


@GOverride 
public View onCreateView (LayoutInflater inflater, 
ViewGroup container, 
Bundle savedInstanceState) { 
View view = 
if EA ile CE E me 112 626 ORS MOI GE E a ES E ل‎ LAVOE, 
container, false); 


LvArea = (TextView) 

Ui eW EAA EWE ك ل رز‎ (RTE. (حت دض بتع‎ 
tvPopulation = (TextView) 

e E OVE VERY LOR TE EEO ELS E OR 
tvLargestCity = (TextView) 

vU eW f IMOVIE WE YN OR TE EVLA EOE SECS EVD) 
ivMap = (ImageView) 

view.findViewById(R.id.ivMap) ; 


return view; 


} 


public void itemSelected(String cityName) { 
0 6 1ت ضع‎ EY Se EE E LE (CEE 2120-5 
11 (cityName.equals ("Gaza") ) 1 
tvArea.setText ("Area: 360 km2"); 
EVEOPU La 6 OME SERE Meze (EOI La E ORE 
1, 8167,9197 ع‎ 
EVLA 09-5 6611 دك 6 56 : / 1ع‎ 26 ) "21209515 CEY: 6223 ( : 
ivMap.setImageResource (R.drawable.gaza) م‎ 
}Jelse if )...( { 
1 TE GRSEMEG لت‎ dO ل‎ else 


صفحة . 177 


١ نضا‎ OO AS ONE ذذا كه‎ | 


ا ادا تتم الم كن 


OO كت ل‎ ONE شا‎ |)١5 | ٠ تت‎ 


كت ل ا 


ىا 


N N N ثم‎ | 
SS © 


N 
دن‎ 


N‏ ذخا WWW WNN N N N‏ (ن) تب) (ب) (ب) (ي) 
کا إن رت ل كه فا نت ٠‏ | ك8 ذن) كحنم إرن) رك لد 


الكلية الجامعية للعلوم التطبيقية 


عنوان الكتاب 


رقم المقرر 


لاحظ أن الدالة ()1041246 (أنظر الأسطر من 12 إلى 14) التي يتم تنفيذها داخل الدالة ()20162]65716ه 
تستخدم ملف الواجهة المنشأ مسبقاً 21م606_1339:00].:2ع06]3115603 لإنشاء واجهة القطعة أثناء تنفيذ الدالة 
.onCreate ViewÛO‏ 

الدالة ()ع)ءء1ء5 مم (أنظر الأسطر من 26 إلى 37) يتم من خلالها تعبئة عناصر الواجهة بناء على اسم 
المذينة المدخل إلى هذه الدالة. من المفترضن أن يتم استدعاء هذه الدالة عند التقر على اسم المديدة من القائمة 
(11569/161) الموجودة ضمن قطعة ]1120760 أخرى. 


ه Fragment‏ stاMy:‏ وتمثل الفئة (1355ح) الخاصة بالقطعة ()معممع2:©) التي تعرض قائمة بأسماء المدن 
بحيث يتم عرض معلومات عن المدينة التي يتم اختيارها ضمن القطعة .MyDetailsFrag ment‏ 


TE لل 5225م‎ 25-5 MUL SEBEAISMERNE 22222115 122-0120217 ! 

2: 

3: MyListFragmentListener listener; 

4: 

ع0 221 م0177 0 :5 

6 public View onCreateView (LayoutInflater inflater, 
71: ViewGroup container, 

9: Bundle savedInstanceState) { 

3: return 

1008 E 1151 5816 E AEE EE 115376115 I SE A SRE E م1761‎ 
115 EOE ER, 1331ل‎ 8 

1 } 

15: 

14: @Override 

15: public void onActivityCreated (Bundle 

E 55 2ت‎ 6 ARCE SESE) 

17 super.onActivityCreated (savedInstanceState) ; 
1 SEE MO )[| Za 05-5 

198 1" 062 1-55 1117 , "63253 , RamallaRLl, lUeninl, NablUSL, 
20: "116 لس‎ AN لات اا‎ 1 5 UMIR ES, لم ير"‎ LARSEN | 
28 ArrayList<String> listValues = new 

O‏ اك سلك مدع 5ك 6 1-5 11 2 كعك 2 شاك 

29: E OE ME MO, dS CANES ERO تكلم‎ E) 

24 11551731115 . 3200 (values [i]); 

25 ArrayAdapter<String> adapter = new 

| () 7ع 711 لك ع تك عات 0 ) CESS EEO‏ 5ت 1ك رز اك عل مام 26 

20 ARO OLE o LAVOE. SLMOLe LISE 1EM 1, LIASCVALUES) 7 
28 aA SEVE MSE < (MSE 

29 this.getView() .findViewById(R.id.cityListView) ; 
80 list.setAdapter (adapter) م‎ 


صفحة. 178 
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liSE.SeECONLEeMCI1 1 CKLI Stener (New‏ 3 
؟ () stener‏ 1-2111 012115512101 32:7 
E‏ 
@GOverride‏ :34 
public void onltemClick (AdapterView<?2>‏ 5 
| 16 كت ! الكت 2 EVA EW, VIEW UE, AME SOS‏ 563565 36 
String cityName =‏ 3 
O‏ 116 1ع 265 - OSE NSE SEE EECA E ESS ME HOR (EOS ETON‏ 
1f (listener != null)‏ 892 
li SEener itemseleCEed (C1 E VName) ;‏ :40 
/ :41 
NF‏ :42 
1 :49 
:44 
public interface MyListFragmentListener {‏ :45 
ECM)‏ لوت داكت 15 Se‏ 260ل عدج ت ) 634 12ت 2105 215 E VON‏ 1 وناك :46 
( :47 
:48 
@Override‏ :49 
E)‏ كك SEM AEE E‏ عات اجام SOE BOONES VONO‏ 
EE 0‏ 12 2ت 2 ) كلت 1ت ع عا الت : عدت ك1 5 51 
1 ( عدت اك 2 5 OE MUL 5 2 8 16 2 620217 ELS‏ 26 ات 6 2112-5 07 6 2 0 6 26 ) iE‏ 52 
listener = (MyListFragmentListener)‏ 5 
عات 7 54:5 
}else{‏ 55 
throw new‏ 56 
() فد هدع EOS‏ 221607 1 ع 6 2) لت نك عام 6ك SME ERAS SCA SEE‏ 
gS + " Activity must implemenet‏ 
LL)‏ تدك ELIS‏ 201121 816 ع 101115115 :59 
} 60 
OL J‏ 
62 


الدالة ()ع]10413 (أنظر الأسطر من 9 إلى 11) التي يتم تنفيذها داخل الدالة ()000623]67/161 تستخدم ملف 
الواجهة المنشأ مسبقاً [دس:.]اه0)_135:0ء مع ]115 لإنشاء واجهة القطعة أثناء تنفيذ الدالة ()/«000162]61716. 
لاحظ أنه عند ربط القطعة بالفعالية الأم يتم تلقائياً تنفيذ الدالة ٠۸)10‏ حيث تم كتابة هذه الدالة ليتم حفظ مؤشر 
للفعالية الأم (9)ز«ناءه) وذلك لتمرر إليها الأوامر لاحقاً (أنظر الأسطر من 50 إلى 61). القطعة 
171381601 فن المفترض أن تمرر اسم المدينة التي يتم اختيارها إلى القطعة الأخرى 
76 وهو ما يجب أن يتم عن طريق الفعالية الأم. 
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في الدالة ()1717016260] حرم (أنظر الأسطر من 15 إلى 43) يتم إنشاء قائمة بأسماء المدن ومن ثم تمريرها 
إلى محول من نوع 1]61م41:33:803 (أنظر الأسطر من 25 إلى 27). يتم بعد ذلك الوصول لقائمة العرض 
(1.15]97/1617) عن طريق الدالة (820197168/8[/100 ومن ثم تمرير المحول 161م41733:403, إلى قائمة العرض 
(15]5/1617.]) لتعبئها (أنظر الأسطر من 28 إلى 30). لاحظ أنه تم اختيار الدالة (4.0191590168]604.رمه تحديداً 
لأن الفعالية (Activity)‏ تكون قد اكتمل إنشاؤها عند تنفيذها وبالتالي يمكن تنفيذ الدالة 
Fragment.getActivityÛ‏ والتي تلزم عن إنشاء المحول .Array Adapter‏ 


ثالثاً: إنشاء واجهات الفعاليات (و400516) 


بعد انشاء القطع «(Fragments)‏ سنقوم الآن بإنشاء الفعاليات (activites)‏ التي ستستخدم القطع لإنشاء واجهة 
التطبيق. لاحظ أن التطبيق يعمل بطريقتين بناءٌ على اتجاه شاشة الجهاز: اذا كان الجهاز أفقياً (Landscape)‏ يتم 
عرض واجهة واحدة تشمل كلا من MyListFragment‏ و .MyDetailsFragment‏ أما إذا كان الجهاز 3 
(20:15:010)» يتم عرض My istF rage”‏ في فعالية» و6عدمع 11712612115112 في فعالية أخرى. 


لتنفيذ ذلك ننشئ ملف التصميم التالي 01:.منهدط_7169]ع2 »والخاص بالواجهة الرئيسية في الوضع الأفقي 
(©13205635)» ونضعه في المجلد ]123'010: 


<LinearLayoutxmlns:android="http://schemas.android.com/apk/ 
res/android" 

Samm SE 1ه هع‎ 5-7 6 65 : / / 5 2121012-57 ARO OMA COM EOL SL 
android:id="@+id/LinearLayout1" 

AREA EORG HAVO E EGE MS male MOAN E 

E‏ 216 م MeO 82 male MR‏ 12ت 121 :1ك تنك رات 

android:paddingBottom="@Gdimen/activity_ vertical _ margin" 
android:paddingLeft="@dimen/activity_ horizontal margin" 
android:paddingRight="@dimen/activity_horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 

EOS LS 2: عا عدت المت‎ > ( MAR AG E ع ل‎ 


CO EA GMO E 

android:id="@+id/listFragment" 
android:name="ps.edu.ucas.fragments.MyListFragment™" 
android:layout_ width="O0dp" 

we GRE >‏ 1157065 :010 1 له 

3202010 : layout_height="match_ parent"/> 


> 1 236010 121 

android:id="@+id/detailsFragment" 
android:name="ps.edu.ucas.fragments.MyDetailsFragment" 
aRAEO1 GA: la VOUE wi OE R> OSE 

ARE EOE SAMO _ 8 ك5 10ر16‎ 
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android:layout_height="match_ parent"/> 


</LinearLayout> 


لاحظ أن الواجهة تضم القطعتين MyListFrag men)‏ و MyDetailsFragment‏ وكل منهما يشير إلى الفئة 
(01355) الخاصة بالقطعة من خلال 2201010:02206. 


بعد ذلك نقوم بإنشاء ملف الواجهات الخاصة بعرض التطبيق في الوضع الرأسي (ازه۲)إه٥).‏ كما ذكرنا مسبقاًء 
يستخدم التطبيق في الوضع الرأسي 201]281) واجهتين تستخدم كل منهما قطعة مختلفة. الملف التالي 
1لتء:.منهةمم_01اعج يوضح تصميم الفعالية التي تتضمن (213:11501138171616)» حيث يتم وضع الملف في 
مجلد باسم 016م-]133:011 حتى يتم استخدامه تلقائياً في الوضع الرأسي (انه0۲)۲٥).‏ 


لاحظ أن اسم ملف الواجهة [20117169:_20810.:00 يطابق اسم ملف الواجهة المنشأ مسبقاء ولكنه موجود في مجلد 
آخر. عند تشغيل التطبيق يتم اختيار الملف من المجلد الصحيح بناء على وضع العرض: فإذا كان العرض رأسياً يتم 
إنشاء الواجهة من الملف الموجود في المجلد 01]6م_1350104 وإذا كان العرض أفقياً يتم إنشاء الواجهة من الملف 
الموجود في المجلد 1358/0106. 


> 1112© 3213570111 
xmlns:android="http://schemas.android.com/apk/res/android" 
SRS: EOS US "11105 65 // SORES ARE FOLA COM EOC SL 
android:id="@+id/LinearLayout1" 
تنك له‎ © 14 2 a OU E AG ERS Nma EER Pa Een E 
15ت 61/1121 1ه لكت 10ت‎ MeO MES ات 16م لات 2ت‎ 
android:paddingBottom="@Gdimen/activity_vertical margin" 
android:paddingLeft="@dimen/activity_ horizontal margin" 


android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
EO SS : COME CEE SE MANOA CEE NEY > 


€ E 2 

android:id="@+id/cityFragment™ 
android:name="ps.edu.ucas.fragments.MyListFragment" 
AR 1ك‎ 5 MG E A OUI MEE RS OS 
AME EOE ال‎ 2576105 EE E 7 117 
AMIE EA VOUE Mel سارو‎ E > Malm PAECMEL > 

</LinearLayout> 1 

ونقوم أيضاً بانشاء ملف واجهة آخر خاص بالفعالية التي تعرض معلومات المدينة في وضع 20107216 ويحتوي 

:MyDetailsFragment على‎ 
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NEED 2 / / 615 7 1 لت‎ COM E OOS 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:tools=" 


android:id="@+id/LinearLlLayout1l" 


SOE E EA E 


android: tag='" 


ARE HOG E 2201 16ت‎ EGE MS Ima 6م لات‎ E 

ست تم SA OME Me HOMES EMA EEN‏ 11ت عذك لت 
android:orientation="vertical"™‏ 
android:paddingBottom="@Gdimen/activity_vertical_ margin"‏ 
android:paddingLeft="@Gdimen/activity_ horizontal _ margin"‏ 


android:paddingRight="@dimen/activity_ horizontal margin" 
android:paddingTop="@dimen/activity_ vertical _ margin" 
EOS LS 2 تكرت 5 كت‎ SL Dell SAE EE 


E EA GME E 


android:id="@+id/detailsFragment" 
android:name=" 
ps.edu.ucas.fragments.MyDetailsFragment™ 


A VOU MEE Sma EER Pa EEN E 
layout Mel ORME WEAD COMECN EL > 


AME ك1‎ © 1: 4 5 


1 3 4ت 2111-6112 


> / 11232137011 < 


الترتيب النهائي لملفات تصميم الهيكلية للفعاليات (41171165) و القطع (2©265مع73) ضمن ملفات التطبيق 


يظهر كما بشكل 9-5: 


4 > layout 
| activity_main.xml 
O) detailsfragment_layout.xml 
CO] listfragment_layout.xml 
a خخ‎ layout-port 
CÎ] activity_details.xml 
CÎ] activity_main.xml 


شكل 9-5: ترتيب ملفات الواجهة الخاصة بتمرين 9-1 


رابعاً: إنشاء الفعاليات (و4017166): بعد إنشاء الواجهات الخاصة بالفعاليات 
(و013556) الخاصة بها: 
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ه الفعالية 2/1310/41191: وتمثل الواجهة الرئيسية للتطبيق: 


1: public class MainActivity extends Activity implements 
2: MyListFragmentListener { 

35: 

4: @GOverride 

5: protected void onCreate (Bundle savedInstanceState) { 
6 super.onCreate ) 5 370125132253 ( م‎ 

7 SEE COM EER نت لشت‎ OR AOE aE ا ل‎ MA MD) 

8: } 

5 

OE 11 

CAE YNEME) |‏ كلل صدعات ) كعات كت لكت 1ت 2 MOMS‏ 1812م !ا 
MyDetailsFragment fragment = (MyDetailsFragment)‏ 1 
this.getFragmentManager )( .findFragmentById )‏ :13 

م ASMERE)‏ 21 1113م 6 815 161 18 148[ 

1: 11 (fragment != null && fragment.isInLayout )(( { 
16$ fragment. itemSelected (cityName) ; 

الك [ 1 

1008 NECME CM EERE > Mew 

[152 11 6 ف كر 6 65 ) اوت‎ EAE OREOR EEE OF 

203 156231 855 6611557 CS SS) ع‎ 

2 1115 6 كلت‎ E دكت :)22 ص عا لظ عا لاك‎ E VNamel, Ci ع‎ 212102 J; 

2 SE مات‎ E كعات‎ E (MEE E) 

2 } 

2 } 

202 


لاحظ أن الدالة ()56]0026269/168 (أنظر سطر رقم 7) المسؤولة عن ربط كود الفعالية بملف الواجهة يستخدم 
الملف المعرف ب («نهه_راز1۷مه). نظراً لوجود ملفي واجهة بنفس الاسم (نهه_رازناعه)ء أحدها في المجلد 
1801 والآخر في المجلد ۲إ0م-اںمره[ء يقوم النظام تلقائياً باستخدام الملف المناسب بناء على وضع الجهاز: 
ففي وضع الشاشة الأفقي يتم استخدام ملف الواجهة (منهص_راإ1عه) الذي يتضمن MyListFragment‏ و 
6115118106101 . في الوضع الرأسي يتم استخدام ملف الواجهة 2005717_1221 الموجود في المجلد 
]نة01م-1ا139:0 والذي يحوي )مهرمع 219115022 فقط, لاحظ أيضاً أن الفعالية تقوم بعمل tعصإعامص:‏ 
للواجهة البرمجية 0©17ع]7604115]1156مع72197113 وذلك حتى تتمكن من الاستماع للحدث الصادر من 
.MyListFragment‏ 


عند استقبال حدث ما من )رع دصعه۴۲ء1 Ny‏ (عند النقر على اسم مدينة من القائمة (Wع۷1ء1)؛‏ يتم تنفيذ الدالة 
ecte0اe item‏ والتي يمرر لها اسم المدينة التي تم اختيارها من القائمة (سء1۷1ء11) (أنظر سطر رقم 11). 
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الإجراء المتبع بعد ذلك يعتمد على وضع شاشة الجهاز: فإذا كانت الشاشة أفقية فإن القطعة 
71610 همبمن المفترض أن يكون ضمن الواجهة الرئيسية وهو ما يتم التحقق منه من خلال تنفيذ 
الدالة (00ا1510133:0 (أنظر سطر رقم 15). إذا كان 2614ع 217120612115118 موجود ضمن الواجهة يتم إرسال 
النص له من خلال الدالة ()0ع1ه025616ع1]6 المو جودة ضمن 719126131151181 (أنظر سطر رقم 16). أما 
إذا لم يكن )دمع 111101211512 موجودا فهذا يعني أن الجهاز في الوضع الرأسي» ومن ثم يتم إنشاء فعالية من 
نوع 10663115411719 وإرسال نص الخبر لها من خلال هدف (12]626) (أنظر الكود من سطر 18 إلى 23). 


ه الفعالية و0101 1(62115.4: هذه الفعالية يتم عرضها فقط في الوضع الرأسي لإظهار تفاصيل الخبر: 
BUS CLASS Della LS REE EY CEES AEE E‏ 


@GOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 


EE CERES : 035 212 CSO ECE SK : 0 56 12ت‎ HOES E OM OE 
OEE Ea EO 5= COME OMA OD E OE TE NAT TON REND :لظ‎ 
EES eS 
E@ E UII 


< e 05 ا‎ e كن إن‎ CU O | ل‎ 


/ 
SE EG SIE E VE OE EOE AEE Ey OE اك تع‎ 
عضت علسلا‎ imeem - EMIS SE ELIM ECR E )( 
EUR LE تالت الله < 5ط عكرت‎  GEEESEEA S (E 
E )222 621225 L> MUD 
String cityName = 
ع جلت 6 كلك‎ E OEE S OEE SE ETE (LEN E Na me E) 
MyDetailsFragment fragment = 
9 (MyDetailsFragment) 
20: this.getFragmentManager )( .findFragmentBy Id ) 
2153 RTO OCEAN NS BEASMER E) 
22 1 4عطع»ع لع 225ع6 1 . 121ع2390102‎ (cityName) ; 
25: } 


0 ل‎ e حنم رن‎ CO O E @ ه٠. ء‎ 


لاحظ أنه عند إنشاء هذه الفعالية يتم تنفيذ إجراءين أساسيين في الدالة onCreate()‏ وهما: 


أولاً: التحقق من وضع شاشة الجهازء فإذا كان الجهاز أفقياً لا يتم عرض الفعالية ويتم إنهاؤها بتنفيذ الدالة 
tivity. finish)‏ (أنظر الكود من سطر 7 إلى 11). 
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ثانياً: استقبال الهدف (]ء]م]) المرسل من 76عرمع219:115]1::3 من خلال الفعالية المضيفة 3101697]اع 21/314 
ومن ثم استخراج البيانات المرسلة وتتضمن أسم المدينة التي تم اختيارها (أنظر الأسطر من 13 إلى 17). من 
المفترض بعد ذلك إرسال اسم المدينة إلى القطعة 06عرمع 2131064211512 والمسئولة عن عرض التفاصيل. لذلك 
يتم الوصول للقطعة ]1ع72مع7241391(6]2115112 عن طريق مدير القطع ومن ثم تمرير اسم المدينة من خلال الدالة 
item Selected)‏ (أنظر الأسطر من 18 إلى 22). 


مربعات الحوار (5ع121210) 


مربع الحوار (ع1(13108) هو نافذة صغيرة تطلب عادةً من المستخدم اتخاذ قرار أو إدخال معلومات إضافية. مربع 
الحوار لا يملأ الشاشة كما هو الحال في واجهة الفعالية (/4015911)؛ ويستخدم عادة في الحالات التي تتطلب من 
المستخدمين اتخاذ إجراء ما قبل أن يتمكنوا من المضي قدما. شكل 9-6 يوضح أمثلة على مربعات الحوار 
:Dialogs‏ 


Text message limit 4 


Set number of messages to save: 


You'll lose all photos and media! 


ار 


Cancel Set 


شكل 9-6: نماذج لمربعات الحوار (12121085) 


الفئة (1355ء 1013105) هي الفئة الأساسية التي تتفرع منها الأنواع المختلفة لمربعات الحوار. ينصح بتجنب 

استخدام الفئة (Dialog class)‏ لإنشاء مربع الحوار 8 وبدلا منه ينصح باستخدام أي من الفئات الفرعية 

(062135565او) التالية: 

161]213108ى: وهو مربع حوار يمكنه افتراضياً عرض عنوانء ثلاثة أزرار بحد أقصىء قائمة من عناصر 
الاختيار أو تصميم مخصص 1a0)‏ 1151010 0. 


ه DatePickerDialog‏ و imePickerDialogا:‏ وهي مربعات حوار تستخدم لتحديد الوقت والتاريخ» 
وتظهر في شكل 9-7: 
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Set date Set time‏ 
Oct 10 2012 1 2 8 AM‏ 
Cancel sk Done‏ 


شكل 9-7: مربعات حوار من نوع DatePickerDialog‏ ف TimePickerDialog‏ 


هذه الفئات (01325565) تحدد شكل وبناء مربع الحوار ع1(1310:» ولكن يجب استخدام كائن من نوع 
DialogFragment‏ كحاوية Container‏ يتم من خلاله إنشاء وعرض مربع الحوار (1013105). استخدام 
مدع 13ع101310 كحاوية لمربع الحوار يضمن معالجة الأحداث النائجة عن دورة حياة مربع الحوار بشكل 
صحيح» حيث ترتبط دورة حياة مربع الحوار بدورة حياة القطعة ٤٣ص‏ عه۴۲عهاه51. يمكن مثلاً تنفيذ إجراء عند 
النقر على زر عآع83 بإضافة كود في الدالة ()70626.052282156ع123ع1(1210. بالإضافة إلى ذلك» استخدام 
Dialog Fragment‏ كحاوية لمربع الحواية يوفر إمكانية إعادة استخدام مربع الحوار في تطبيقات أخرى تماماً كما 
يحدث في حالة القطعة ()معرمع 122). 


تمرين عملي (9-2) 


يهدف هذا التمرين إلى التدرب على إنشاء مربعات حوار (1(121055) من أنواع مختلفة. الواجهة الرئيسية للتطبيق 
تظهر في شكل 9-8 وتتكون من مجموعة من الأزرار عند النقر على أي منها يظهر مربع حوار ع101210 
بخصائص محددة. 
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Simple Alert 
Custom Dialog 


List Dialog 


Time Picker 


شكل 9-8: واجهة التطبيق الرئيسية الخاصة بالتمرين 9-2 
في ما يلي نستغرض مربعات الحوار Dialogs‏ المختلفة وطريقة إنشائها: 


أولاً: مربع الحوار ع1(1310 1616.: وهو يظهر عند النقر على الزر "4116 عامpص1؟'‏ كما بالشكل 9-9: 


۶ 


Do you study at UCAS? 


شكل 9-9: مربع الحوار (عهاه¡۲5٤١ء۸1)‏ الخاص بالتمرين 9-2 
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عنوان الكتاب 


رقم المقرر 


الكلية الجامعية للعلوم التطبيقية 


لإنشاء هذا المربع (ع1(1310)» قم بإنشاء فئة (01255) باسم ع1641616101210م2197:510 والتي تتفرع من الفئة 


1181611 وتحتوي الكود التالي: 


public class MySimpleAlertDialog extends 
DialogFragment { 
@GOverride 
public Dialog onCreateDialog (Bundle 
savedInstanceState) { 
عرزت للم‎ DEA LOC EI LOSE BE OEE - MeN 
Al GEE Di 2 1 OG o BUA LCC (GOEACTIVI EY D8 
builder.setMessage ("Do you study at UCAS?2"); 
this.setCancelable (false); 
um GEE SEER ELE (OME SET ORL, 
builder.setIcon (R.drawable.ucaslogo) م‎ 
builder.setPositiveButton ("Yes", new 
OnClickListener () { 


@GOverride 
BEBE OAS OMNES ) تع 1 مت 11د انض‎ 2265 OE LOS, 
عاك‎ aE) ! 
1163 5 E : 112152 Next ت و)‎ EACEIVIEY (J, YOU ake 
a UCAS student", Toast. LENGTH LONG) . 51077 )( ; 
/ 
م‎ 
builder.setNegativeButton ) "210", new 
OnClickListener )( { 


@GOverride 
5115م‎ OMS OMG IEEE (DIS HOS IEEE AEE AMA LOS 
E lose) |! 
1939 515 Mma ke 1 ل كات شت ت 0 ) عكرت‎ VEY )( | MOD 21 
OE a UCAS 52 اع‎ MOSSE للستت‎ LONE) SRO 
/ 


})7; 

AlertDialog dialog = builder.create )( : 
dialog.setCanceledOnTouchOutside (false); 
FEUER Gla OI, 
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الكلية الجامعية للعلوم التطبيقية عنوان الكتاب 
رقم المقرر 


لإنشاء مربع الحوار ع81611(1210 المطلوب يتم كتابة الكود في الدالة ()ع1(1210ع000636 والتي ترجع كائن 
من نوع ع1(1310. كما تلاحظ يتم في البداية إنشاء كائن من نوع 1ع1110ا816161(12108.8 (أنظر سطر رقم 6 
و7) والذي يتم من خلاله تحديد خصائص مربع الحوار. لاحظ أنه تم تحديد الرسالة المعروضة في مربع الحوار 
باستخدام الدالة ()عع56)816552» وتم تحديد العنوان باستخدام الدالة ()56]13616 والإيقونة الظاهرة في مربع 
الحوار باستخدام الدالة ()02ح56]1 (أنظر الأسطر من 8 إلى 11). 


يمكن أيضا من خلال الكائن من نوع 8111061 تحديد الأزرار والنصوص المعروضة بها والإجراءات التي تنفذ 
عند النقر علي أي من هذه الأزرار. يمكن إفتراضياً إضافة ثلاثة أزرار بحص أقصى داخل ع816]1310, وذلك 
باستخدام الدوال setNegativeButton) «setPositiveButton0‏ و tNeutra]Button)Oءء‏ (أنظر الأسطر 
من 12 إلى 32). كل دالة من الدوال السابقة يمرر لها النص الذي يكتب على الزر (مثل 016 أو وع) بالإضافة 
إلى كائن من نوع (06©17ع]15.آ02001101) يحدد الإجراء المراد تنفيذه عند النقر على الزر. كود الإجراء المطلوب 
يتم كتابته في الدالة .OnClickListener.onClick‏ 


بعد تحديد خصائص مربع الحوار ع8161101210 »يتم إنشاؤه بتنفيذ الدالة ()ع81111061.01626 والتي ترجع كائن 
من نوع ع121310. في النهاية يتم إرجاع الكائن ع1(1210 كمخرج من الدالة ()ع08016261(1210 (أنظر الأسطر 
عن 35 إلى 35): 

لاحظ أننا استخدمنا الأمر Dialog.setCanceledOnTouchOutside(false)‏ (أنظر سطر رقم 34) لتجنب 
إغلاق مربع الحوار عند النقر خارجه كما يحدث إفتراضياً. في هذه الحالة لن يتم الإغلاق إلى من خلال الأزرار 
الموجودة داخل مربع الحوار. 


ثانياً: مربع الحوار المخصص 1018106 27ه1156© (أنظر شكل 9-10) ويظهر عند النقر على الزر صہہاوںع“ 
”0 الظاهر في شكل 9-8 . 
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رقم المقرر 


Enter username and password 


Username: ibrahim 


Password 


3 


corer 


202060] 06] > 


EEG >‏ ا ]ل اع #1 


123 "5 05 7 "5 
sym + تآ‎ 7 Done 


شكل 9-10: مربع الحوار المخصص (1(12105 01154012)) الخاص بالتمرين 9-2 


مربع الحوار المخصص يوفر إمكانية استخدام تصميم معد مسبقا في ملف هيكلية من نوع .23411 لبناء واجهة مربع 
الحوارء وهو ما يعطي مرونة أكبر في تصميم الواجهة من مربع الحوار 416161013108 الإفتراضي. الكود التالي 
يمثل الفئة (class)‏ الخاصة بمربع الحوار المخصص: 


public class MyCustomDialog extends DialogFragment { 


@GOverride 
public Dialog onCreateDialog (Bundle 
savedInstanceState) { 
AlertDialog.Builder builder = new 
AMEE EDA LOSE BUS LOSE (OC EAC EE (DD 
Buni Ider . Sel Ele ) LENEeE 15912112112 ana 225561290 ( : 
157610 6 عرت عات ل ع ل‎ inf ! 26 غات‎  (LIAVOUE UNE عدت 26 1ك‎ ( 
EMS : عاك كش عا مان‎ 1 EV )( ٠ 0 ت‎ ELAYOU عا‎ IRE 1-2 6 عدت‎ )( 
View view = 
im 11 عدت ع د‎ im Kalle (RE SMO MIE 2 تك‎ EOE, MUO, 
builder.setView (view) م‎ 
Button btnOK = 
(BUEE OR) UTE E IMOVIE WE كد 5 1) 1241 رز‎ BENO) 
btnOK.setOnClickListener (new OnClickListener () { 
@GOverride 
BUS LN E VOM لت 1 لله‎ MTe 220 
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رقم المقرر 
Toast.makeText (getActivity (), "Thank‏ 1 
OE, Hoa SE HENGE SHO ESO O‏ 205 
SMA SS (JF‏ 1ك E OMDI a LOG: ERAS.‏ 5 01 1157 و2 
} 22 
9E‏ :25 
EEE IER OU LIE ERE AEE E‏ :24 
J‏ 2908 
208 


لاحظ أن إنشاء مربع الحوار المخصص مشابه إلى حد كبير لطريقة إنشاء مربع الحوار الإفتراضي المنشأ في 
الخطوة السابقة» فهو من نوع ع416101(1310 ومضمن في 6معدمع712ع1(1310. الاختلاف الوحيد أنه تم استخدام 
كائن من نوع 133/01161211361 لإنشاء الواجهة باستخدام ملف واجهة بالمعرف R.layout.dialog_layout‏ 
(أنظر سطر رقم 11 و12). الواجهة المنشأة تكون مضمنة في كائن من نوع سه۷ يتم إضافته لمربع الحوار 
باستخدام الدالة ()011067.56]1716ا8 (أنظر سطر رقم 13). بعد إنشاء الواجهةء يمكن الوصول برمجياً لأي 
عنصر داخلها بتنفيذ الدالة ()5201716183:10 وذلك لإضافة مستمع (7عمع]115) لحدث معين. في المثال 
الموضح يتم الوصول إلى الزر المعرف ب 12.11.0016 ومن تسجيل مستمع (1.15]6061) لمعالجة إجراء النقر 
عليه (أنظر الكود من سطر 14 إلى 23). 


ثالثاً: مربع حوار يعرض قائمة من عناصر الإختيار كما يظهر في شكل 9-11 » ويتم إنشاؤه عند النقر على زر 
”1108 1156“ الموجود ضمن الواجهة في شكل 9-8. 


Choose your favorite colors: 


شكل 9-11: مربع الحوار يعرض قائمة من العناصرء الخاص بالتمرين 9-2 


الخاصية (5]1108-21123 كما هو موضح: 
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عنوان الكتاب 


رقم المقرر 


SEM هت ده مدعي‎ N. OL ده 6 822 هئ هك كرت‎ 
<resources> 
<string name="app name">dialogtest</string> 
<string name="action settings">Settings</string> 
<string name="hello_world">Hello world!</string> 
SS ETE AE BA Mame > COO AE EE 
<item >Blue</item> 
<item >Red</item> 
<item >Green</item> 
<item >Black</item> 
<item >White</item> 
</string-array> 
</resources> 


الفئة (ووهاء ع6137:1156101210) التالية توضح طريقة إنشاء مربع الحوار : 


15 لاك‎ 11115 CLASS 1511 5 للك 1 شع‎ OS 2د‎ 12212615 Dial عوك‎ 16 2-0212 1 f 

0 

3 Boolean[] selections = {false, false, false, false, 
4: false}; 

5: 

6 @GOverride 

0 public Dialog onCreateDialog (Bundle 

8: savedInstanceState) 1 

548 AlertDialog.Builder builder = new 

NOE AEE EDLaA LOSE BULGE E (OE عت تع‎ EY ODE 

I: UGE Se EAE LE (LACROSSE VOU EASE EE :كلهت‎ !( 
2: BUNGIE E: se EMU ETCRON EE NEEM S (E تست‎ 20 7 COLO AEEAV, 
1J: Hull, hew تنتطمة‎ 1 2105531 38601111136282 f 

14: 

E @GOverride 

1005 لظام‎ 13 ONE OME Un eR ) 1 216 2 عت‎ 2-22 Qua lOO, 
17: int which, boolean isChecked) { 

1 selections [which] = isChecked; 

9 / 

20 J); 

builder.setPositiveButton ("OK", new‏ و 

' () غك SEER‏ كلت 026011 222 

20 

2 @GOverride 
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رقم المقرر 
CAE OS‏ تع 6 1 SONS ORME ONE EEE DE KOS‏ :25 
ROD)‏ 1ك 265 
د SENE Ee SE‏ 2 
for (Boolean selection: selections)‏ 0 
;" ,م result+=selectiont"‏ :20 
VEY )( | EESULE,‏ ل كات شع ت 0) CMa EREN E‏ 515 17059 :0 
SE Toast. LENGTH LONG) .show();‏ 
} 327 
م 5 
return builder.create ();‏ :34 
} :35 
SOF}‏ 


لاحظ أن مربع الحوان ك أنشاؤه بطريقة مشابهة لمريغات الحوار 'السائقة باسشاء استخام .الدالة 
)ui1der.setMultiChoiceltemsOاB‏ والتي يمرر لها معرف المصفوفة التي تم إنشاؤها وهو 
R.array.color_array‏ وكائن من نوع Listener)‏ tiChoiceClickا0nMu)‏ والذي يستخدم للاستماع لحدث 
اختيار عنصر من القائمة حيث يتم تلقائياً تنفيذ الدالة ()000111 عن النقر على أي عنصر (أنظر الكود من سطر 
2 إلى 20). 

لاحظ أن الدالة ()5ودطع]][ء81111061.56]3/111101016 تستخدم لتفعيل خاصية الاختيار المتعدد من قائمة العرض. 
يمكن استخدام الدالة ()75ع]81111061.56651281600101061 لدعم اختيار عنصر منفرد من القائمة. 


رابعاً: واجهة تحديد الوقت ع15262101671(19210 (أنظر شكل 9-12) وهو أحد مربعات الحوار جاهزة التصميم 
والذي يمكن استخدامه في التطبيقات التي تتطلب تحديد الوقت» ويظهر عند النقر على الزر "Time Picker"‏ في 
شكل 9-8: 
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رك الكلية الجامعية للعلوم التطبيقية 


رقم المقرر 


Cancel 


شكل 9-12: مربع حوار من نوع 111621121101210 خاص بالتمرين 9-2 


هناك أيضاً مربع حوار مشابه باسم ع 102671161101310 وهو يستخدم لتحديد التاريخ. إنشاء مربع حوار من نوع 
8 يتم باستخدام الكود التالي: 


public class TimerPickerFragment extends 
DialogFragment { 


@GOverride 
public Dialog onCreateDialog (Bundle 
SavedInstanceState) { 
Calendar c = Calendar.getInstance )( ; 
mE aoe Se Se E (Ca KEME AE OTE OE DAD 
imê MinUEe  CG.Get (Calendar . MINUTE) ; 
TimePickerDialog dialog = new 
11 111 ذخات‎ EEO EDA LOS ERS OEE كعك‎ E (OT e 
OnTimeSetListener )( { 
@GOverride 
BUCO INES VONO OR ime SEE (EME EM Ce eW, MME 
hour, int MinulLe) 
TOA 5 2 Mma Ke Rex E (OC EACE لدي‎ EY), NOU SCE: 
ROE MOE, LMU Ee mE SL, 
Toast. LENGTH LONG) .show(); 
/ 


ا 3 E O‏ رن دن لد ee‏ ھا ا 


LTS‏ ل 


با 


AT‏ الت كم 


O CS Î e O dS O RO E ا د 0 6 تت‎ 
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رقم المقرر 
j, hour, minute, false);‏ م 
لقنا 6 163 2 
} :22 
J‏ 28 


لاحظ أنه تم إنشاء كائن من نوع ع1116211611(1210 وتم تمرير كائن الفعالية (0) رزلا 1Aءع‏ بالإضافة لكائن 
من نوع 061ء]6]1.15 02152265 والذي يحدد الإجراء الذي يتم تنفيذه عن تحديد توقيت جديد (في المثال أعلاه يتم 
طباعة الوقت) (أنظر الأسطر من 12 إلى 22). تم أيضا تمرير الوقت الحالي (بالساعة والدقيقة) والذي تم قراءته 
باستخدام كائن من نوع 02162021 (أنظر الأسطر من 7 إلى 9) إلى الكائن ع62101611(1210ة1] وذلك لتحديد 
الوقت الافتراضي عن فتح مربع الحوار. 


بعد توضيح الكود الخاص بمربعات الحوار (1(131085) المختلفة» سنقوم الآن بعرض الكود الخاص بالفعالية 
MainActivity‏ والتي يتم من خلالها تشغيل مربعات الحوار: 


25 SELE COLES S MEERA GE N EY CEERI ا‎ 

2: 

3: @GOverride 

4: protected void onCreate (Bundle savedInstanceState) { 
5: super.onCreate ) 5 370125153226553 ( م‎ 

6 SE EC OME EM EVE (REO E AC E Ey Mam) 
1 } 

5 

58 public void showSimpleAlert (View view) { 

10 MySimpleAlertDialog dialog = new 

TE MSS مرو‎ LEA LEE EDI aA LOO )( 

22 FragmentTransaction) ftr = 

13: this.getFragmentManager )( .beginTransaction (); 
14: SMA LOSS SRO CE EE 00626 

5 } 

1 

17: public void showCustomAlert (View view) { 

12 MyCustomDialog dialog = new MyCustomDialog (); 
1 FragmentTransaction ftr = 

20: this.getFragmentManager )( .beginTransaction(); 
2 SALO SRO KE EE 062 

223 1 

25: 

24: public void showListDialog (View view) { 

25 MyListDialog dialog = new MyListDialog (); 
26 FragmentTransaction ftr = 

2 this.getFragmentManager )( .beginTransaction )( م‎ 


صفحة . 195 
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a ROG So EE, mv EAS, 
/ 


public void showTimePickerDialog (View view) { 
TimerPickerFragment dialog = new 
TimerPickerFragment )( م‎ 
FragmentTransaction ftr = 
this.getFragmentManager )( .beginTransaction (); 
SALO SRO ) 2 EE my EAC 
/ 
} 


و 
:29 
SOE‏ 
E‏ 
32 
5 
:34 
5 
:56 
0 
:58 


لعرض مربعات الحوار المختلفة يجب بداية الوصول للكائن FragmentManager‏ المسؤول عن إدارة كل ماله 
علاقة بالقطع (0]5عرمع72) ومن ثم إنشاء كائن من نوع 113870621112252610105. لاحظ أن طريقة عرض أي 
مربع حوار 101310 تتم باستخدام الدالة ()1(13108.55017 والتي يمرر لها كائن من نوع 


)۴ragment Transaction)‏ بالإضافة إلى اسم معرف ع12. 


أسئلة على الوحدة التاسعة 
1. ما مميزات استخدام القطع (65معرمع1:2) لتصميم واجهات تطبيقات أندرويد؟ 
ما الفرق بين القطعة ()معمدمع ج2©) والفعالية (رAct1vt)؟‏ 


أذكر طريقتين لإضافة القطع (5)معدمعجء©) للفعالية (ر ز1 )A)؟‏ 


د شأ خد 


قطعة من نوع )DialogFragment(؟‏ 


لماذا ينصح بتضمين مربع الحوار (ع81611(01310) أو أي أنواع أخرى من مربعات الحوار (ع11310) داخل 


5. قد بتصميم تطبيق إخباري بالخصائص التالية: واجهة التطبيق في الوضع الأفقي (6م13005023) موضحة في 
الأسفل» حيث يتم عرض قائمة الروابط (1.1015) على اليسارء وعند النقر على أي رابط يتم عرض التفاصيل 


في المنتصفء» بينما على يمين الشاشة يتم عرض قائمة بالإشعارات و التحديثات, 


في الوضع الرأسي (2011:316) يتم عرض كل جزء من الأجزاء السابقة في فعالية (410197107) منفصلة كما 
هو موضح بالاسفل» حيث تعرض الفعالية الرئيسية قائمة من الروابط في (/1.1569/1695) وأسفلها زر باسم 
 ,,_" 31085"‏ عند النقر على أي رابط يتم إظهار التفاصيل في فعالية جديدة» وعند النقر على زر 


- 


"Notifications"‏ يتم عرض الإشعارات في فعالية أخرى كما هو موضح. 
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Notifications 


لتم 


Notifications 


6, في تمرين 9-2 تم إنشاء مربع حوار مخصص (150171(012108©) (أنظر شكل 9-10) حيث يتم إدخال اسم 


7 


مستخدم وكلمة مرور من خلاله. قد بتعديل التمرين بحيث يتم إعادة البيانات المدخلة إلى الفعالية الرئيسية 
.(MainActivity)‏ 


تلميح: بما أن مربع الحوار (ع4161101210) مضمَن داخل قطعة من نوع (7626مع7172ع1(01210)» يمكن 
استخدام نفس الطريقة التي تم شرحها للتواصل بين القطعة ()مع ممع 222) والفعالية المضيفة (2105710). 


في الوحدة الخامسة» تمرين 5-2 قمنا بإنشاء درج تصفح .(Navigation Drawer)‏ ذكرنا أن تصميم الواجهة 
مكون من جزئين هما الجزء الثابت (7161 0012161214 321331) والجزء المضمن في درج التصفح. ذكرنا أيضأ 
أن الجزء الثابت يمكن إدراجه كقطعة (06ع7مع122) حيث يتيح ذلك إمكانية تغيير المحتوى الأساسي إثناء 
عمل التطبيق عند طريق استبدال القطع (5)مع رمع 2:]). قم بتعديل تمرين 5-2 لاستخدام القطع ()معممع2:2]) 
3 قي هذا الغرض. 
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الوحدة العاشرة: 
نشر ت تطبيقات أندرويد 
(Publishing Android Applications)‏ 
يتعلم الطالب في هذه الوحدة: 


7 خطوات ومستلزمات نشر تطبيق أندرويد على متجر جوجل (2133 ©1ع600). 
7 طريقة تهيئة التطبيق للنشر وتوقيعه رقمياً. 
” إنشاء سجل المطور .(Developer Profile)‏ 

(Google Play Store) متجر جوجل‎ 


متجر جوجل (١إه؟‏ 2133 16ع000) يمثل الآلية الرسمية لنشر تطبيقات الأندرويد. إن نشر تطبيقك على متجر 
جوجل يجعل من التطبيق قابل للتحميل والاستخدام من قبل المستخدمين في جميع أنحاء العالم. يمكن أيضا 
للمستخدمين إضافة تعليقات أو إعطاء تقييم للتطبيق بما يمكن من اكتشاف الأخطاء أو تحسين التطبيق لاحقا. كما 
يوفر متجر جوجل بض الإحصائيات التي يمكن الاستفادة منها لقياس نجاح أي تطبيق. 
في هذه الوحدة سيتم شرح خطوات نشر التطبيق على متجر جوجل (ع5601 21337 16ع600). 
يمكن تلخيص خطوات نشر التطبيق على متجر جوجل بما يلي: 

1. تصدير التطبيق (016م1:2) كملف من نوع „(Android Package) APK‏ 


2. عمل توقيع رقمي (ع515025 1121ع1]) للتطبيق باستخدام شهادة (061012]6). توقيع التطبيق رقمياً 
يساعد نظام أندرويد في تحديد هوية مالك التطبيق. 


3. رفع التطبيق على المتجر. 

4. استخدام سوق أندرويد (6ع35131 011010ى) لاستضافة وبيع التطبيق. 
في ما يلي سنقوم بشرح خطوات إعداد التطبيق للتوقيع ومن ثم سنقوم بشرح طريقة نشر التطبيق: 
تحديد إصدار التطبيق 


ابتداءةة من إصدار أندرويد 1.0» يحتوي ملف الوثيقة (0وج314م34) لكل تطبيق على خاصيتي: 
android:versionCode‏ و 301010:76151001131. قيمة الخاصية الأولى تحدد رقم الإصدار الخاص 
بالتطبيق. لكل نسخة جديدة معدلة من التطبيق يجب إضافة 1 لهذه القيمة وذلك للتفريق بين النسخة الجديدة والقديمة. 
هذه القيمة غير مستخدمة من قبل نظام أندرويد وهي مفيدة فقط للمطورين لمعرفة إصدارات التطبيق. 


قيمة الخاصية android:versionName‏ تحتوي على معلومات الإصدار التي تظهر للمستخدمين وتأخذ الصيغة: 


<major>.<minor>.<point> 
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رقم المقرر 


إذا تم إجراء تغيير كبير على التطبيق يتم إضافة واحد للقيمة :وزومم؛ أما إذا تم إضافة تعديلات أو إضافات صغيرة 
أو ثانوية يتم زيادة قيمة إمصنص أو ا«زمم. فمثلاًء التطبيق الجديد قد يأخذ اسم الإصدار (Version Name)‏ 
التالي: "1.0.0" و عدن عمل تعديل بسيط يأخذ اسم الإصدار "1.0.1" أو "1.1.0". عند عمل تعديل كبير يمكن أن 


يأخذ التطبيق اسم الإصدار: "2.0.0" وهكذا. 


إذا كنت تنوي نشر التطبيق على سوق أندرويد الإلكتروني (/]ع10/50811هه.1777.3011010) » يجب أن تتوفر 


جميع البيانات التالية ضمن ملف الوثيقة (71314516) الخاص بالتطبيق: 


android:versionCode (<Manifest> .(ضمن الخاصية‎ 


android:versionName (<Manifest> .(ضمن الخاصية‎ 


android:icon (<application> .(ضمن الخاصية‎ 


android:label (<application> .(ضمن الخاصية‎ 


المثال التالي يوضح هذه البيانات ضمن ملف وثيقة (وعifمةN)‏ لتطبيق باسم :"UCAS APP"‏ 


<?xml version=”1.0” encoding=”utf-87?2> 
<manifest 
xmlns:android=“http://schemas.android.com/apk/res/android” 
package=“ps.ucas.edu.ps.publishexample” 


Ir 


ANdEO1d:VEES10NCOdE=21 


android :versionName—-<1.0% < 
<USEeS-SdkK android:minSsdkVersion= 13 7> 


EBE EME SSO NRE RE‏ 16 5 1ه 
ماخ م1 SEONG POEM SSO ACCESS EINE‏ 


JEONG Pe EMIS S1 ON. ACCESS COARSE TWOCAT TONLE 


droid:icon=”@drawable/ic_launcher” 


CAS AEE 


<uses-permission 


<uses-library android:name=“”com.google.android.maps” /> 


SLEINI/aPP_ Mame 2 


android:name=”an 
<uses-permission 
android:name=”an 
<uses-permission 
android:name=”an 
>21 5 9 11 2ك‎ 6 LOM 

an 

210 01121 سك 25 للا 1ك‎ =4 U 
GAC 7 
android:label=”@ 


droid:name=”.LBSActiviİity” > 
<intent-filter > 
<action android:name=”android.intent.action.MAIN” /> 

<category android:name=“”android.intent.category. LAUNCHER” 
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>/ اتكاتةتهعة‎ EV 
</application> 
</manifest> 


يجب التأكد من إضافة كل الأذونات (265001551025) التي يتطلبها التطبيق ضمن ملف الوثيقة (أوم؟ نره )N‏ كما 
هو موضح في المثال السابق. لاحظ أيضا أن التطبيق السابق يتطلب إصدار أندرويد 13 على الأقل 01010مة) 
(3.2.1. يفضل استخدام أدنى رقم إصدار يتوافق مع تطبيقك حتى يتمكن أكبر عدد من المستخدمين الاستفادة منه. 
التوقيع الرقمي للتطبيق 
كل تطبيقات الأندرويد يجب توقيعها رقمياً قبل أن يتم تشغيلها على أجهزة أندرويد. توقيع التطبيق رقمياً يضمن 
ضمان موثوقية التطبيق عن طريق تحديد هوية المطور أو مالك التطبيق. توقيع التطبيق يتطلب ما يسمى بشهادة 
رقمية (06101112]6) 1(18121) تكون بمثابة التوقيع المميز للمطور والذي يتم إلحاقه بالتطبيق عند نشره. يمكن 
لون إنشاء الشهادة الرقمية الخاصة به واسشكدامها لتوقيع كه 
عند تجربة التطبيقات على برنامج المحاكاة (220113601) تقوم الواجهة التطبيقية المستخدمة مثل عوم11اء15 
بإصدار شهادة للتجربة ]0610133 عنااء(1 ولذلك لا يتطلب أن يقوم المطور بأي خطوات لتوقيع التطبيق 
رقمياً. أما عند نشر التطبيق» فلا يمكن استخدام الشهادة التجريبية 0610111226 عنااء(1 ويجب إنشاء شهادة جديدة. 
يمكن إنشاء الشهادة باستخدام الأداة keytool.exe‏ الموجودة ضمن .Java SDK‏ كذلك توفر الواجهة التطبيقية 
مثل 6وم11ع2] امكانية إنشاء الشهادة الرقمية وتوقيع التطبيق بها باستخدام ل۷121 . 
المثال التالي يوضح خطوات تصدير تطبيق أندرويد وتوقيعه رقمياً: 

1. اختر التطبيق الذي تريد نشره ومن ثم اختر +011م1:2 <- .۴ile‏ 


ضمن مربع الحوار الذي يظهر افتح القائمة باسم 017010 وقم بالنقر على الخيار الفرعي Export Android‏ 
01 كما هو موضح في شكل 10.1. اضغط على الزر غ:ع11. 
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Select an export destination: 
| عمل‎ filter tect 


General‏ @ م 
Android‏ ® 4 
ıı Export Android Application‏ 
EJB‏ @ > 
Install‏ & < 
Þ @ Java‏ 
Java EE‏ به < 
bÞ @ Plug-in Development‏ 
b @ Remote Systems‏ 
Run/Debug‏ بجع bÞ‏ 
Tasks‏ @ < 
Team‏ @ م 
Web‏ & < 
Web Services‏ @ < 
¥MI‏ .دن ı_‏ 


شكل 10.1: تصدير التطبيق من خلال مومذاءم 
يظهر مربع الحوار بالشكل 10.2 والذي يبين اسم التطبيق الذي سيتم تصديره» ومن ثم اضغط على زر .N6×)‏ 
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®] Export Android Application 

Project Checks 
Performs a set of checks to make sure the application can be exported. 
Select the project to export: 


Project LBS 
No errors found, Click Next, 


شكل 10.2: اختيار التطبيق ليتم تصديره 


ضمن مربع الحوار الذي سيظهر والموضح في شكل 10.3 قم باختيار 163/5101 261 Create‏ وذلك حتى يتم 
إنشاء شهادة جديدة (ع:560/(ءع1 0 061016216)) لتوقيع التطبيق» كذلك حدد المسار ليتم حفظ ملف الشهادة به. 
يجب أيضاً إدخال كلمة مرور لحفظ الشهادة الجديدة حتى لا يتم استخدامها من قبل شخص غير مصرح له. قم بالنقر 
على زر .Next‏ 
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®] Export Android Application 


Keystore selection 


7 Use existing keystore 

Create new keystore‏ ها 

Location: C:\Users\Wei-Meng Lee\Desktop\MyNewCert.keystore 
Password: ]هه‎ 96666 


الل فنا Confirm:‏ 


شكل 10.3: إنشاء الشهادة الرقمية لتوقيع التطبيق 
ضمن مربع الحوار الذي يظهر (أنظر شكل 10.4( أدخل اسم للمفتاح السري private key‏ المستخدم ضمن 
الشهادة Certificate‏ كذلك أدخل كلمة مرور لحفظه. كذلك يجب أن تحدد فتر صلاحية المفتاح private key‏ 
والتي يجب أن تنتهي بعد تاريخ 22-10-2033. لذلك أدخل أي عدد بحيث يكون أكبر من الفرق بين سنة 2033 
والسنة الحالية. بعد ذلك أنقر على زر ):ع71. 
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8[ Export Android Application 


Key Creation 

Alias: DistributionKeyStoreAlias 
Password: cess 
Confirm: wecccccccese 

Validity (years): 30 


First and Last Name: Wei-Meng Lee 
Organizational Unit: 

Organization: 

City or Locality: 

State or Province: 


Country Code 000: 


© Fi 


شكل 10.4: إدخال البيانات الخاصة بالشهادة الرقمية 


ضمن مربع الحوار الذي يظهر كما في شكل 10.5ء حدد المسار الذي يتم فيه حفظ ملف ۸ء ومن ثم انقر على 
زر الإنهاء .Finish‏ 
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4 
5 Export Android Application 


Destination and key/certificate checks 


Destination APK file: C:\Users\Wei-Meng Lee\Desktop\LBS.apk 


Certificate expires in 30 years. 


© er 


شكل 10.5: اختیار المسار لحفظ ملف PK‏ هر 


نشر التطبيق على سوق أندرويد (Android Market)‏ 


الخطوة الأولى لنشر التطبيق على سوق أندرويد (6ع1:ه31 4نهإلمA)‏ هو إنشاء السجل الخاص بالمطور 
(Developer Profile)‏ وذلك من خلال الرابط: .http://market.android.com/publish/Home‏ يجب في 
البداية تسجيل الدخول بحساب جوجل (01126ع40/ 600816)» ومن ثم يمكن إنشاء سجل مطور جديد 
Profile)‏ مرعمهاء1267) كما هو موضح في شكل 10.6. بعد الانتهاء من إدخال بيانات المطور أنقر على 
.Continue‏ 
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Google play ANDROID DEVELOPER CONSOLE‏ مع 


Getting Started 
Before you can publish software on Google Play, you must do three things: 


» Create a developer profile 
» Agree to the Developer Distribution Agreement 
» Pay a registration fee ( $25.00) with your credit card (using Google Checkout) 


Listing Details 
Your developer profile will determine how you appear to customers in Google Play 


Developer Name Michael Burton 
Will appear to users under the name of your application 


Email Address 


Website URL سه مه‎ 


Phone Number - 
Include plus sign, country code and area code. For example, +1-650-253-0000. why do we ask for this? 


Email Updates _) Contact me occasionally about development and Google Play opportunities. 


Continue » 


© 2012 Google - Google Play Terms of Service - Privacy Policy 


شكل 10.6: إنشاء سجل مطور جديد (Developer Profile)‏ 


لنشر تطبيقات على سوق أندرويد يجب أن يدفع المطور رسوم تسجيل وتبلغ 25 دولار تدفع لمرة واحدة» ولا يمكن 
النشر بدون دفع هذه الرسوم. يمكن النقر على زر 116مع1ءع6© ع1ع600 لدفع رسوم التسجيل. كذلك يجب الموافقة 
على اتفاقية جوجل الخاصة بالنشر (172©7246ع2826 1(1511102) بعد قراءتها وذلك بتحديد مربع الاختيار 1 
.Agree‏ 


بعد الانتهاء من إنشاء سجل المطور (201116 6©1م1067610) يتم إظهار الرسالة الموضحة في شكل 10.7 والتي 
تبين أن التسجيل تم بنجاح. 
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9) Google wallet 1 Heo Sign out 


y Thanks Michael Burton, you're done! 
Your order has been sent to Google. Retum to Google » 


Message from Google: 


How do ١ track my order? 
Get up-to-date order progress at wallet.google.com/manage 


€2012 Google Terms of Service - Privacy Policy (Updated) - Google Home 


شكل 10.7: شاشة توضح إنشاء سجل المطور (2701116 )Develop er‏ بنجاح 


قم الآن بالنقر على الرابط 5166 دعمو1ء1<67 :2139 16ع000 والذي يؤدي إلى الصفحة الرئيسية للمطور (أنظر 
شكل 10.8) والتي يمكن من خلالها نشر التطبيقات. 


Michaol Burton 


Google play ANDROID DEVELOPER CONSOLE‏ مج 


Your Registration to Google Play is still being processed. 
You can upload applications ما‎ Google Play but you cannot publish until your rogistration is completed. 


Michael Burton 


سوه 
Et profîl < Manage user accouns »‏ 


All Google Play Android app listings 


Upload Application 


Google checkout 


Want to sell applications and In-app products? 

Set up a Merchant account with Google Checkout! You will need to enter additional information like your bank account infomation 
and Tax ID. 

Setup Merchant Account « 


© 2012 Google - Google Play Tams of Sarvico - Privacy Policy 


شكل 10.8: الواجهة الرئيسية لصفحة المطور والتي يتم من خلالها نشر التطبيقات 
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رفع التطبيق 
بعد إنشاء سجل المطور (2:01116 1ع م10ء1(67) يمكنك نشر التطبيق على متجر جوجل. تأكد من توفر المكونات 


التالية: 

ه ملف )۸۲ الخاص بالتطبيق والذي تم توقيعه رقمياً. 

ه صور (5]م0طومعع501) توضح واجهات التطبيق (صورتان على الأقل). 

«ه وصف مختصر للتطبيق ووظائفه. 
من الصفحة الرئيسية للمطور (أنظر شكل 10.8) قم بالنقر على الرابط 11626102مم6. 1101020 حيث ستظهر 
الصفحة في شكل (10.9) والتي من خلالها يتم رفع ملف ×۸۴ وكذلك ملفات الصور. يجب إيضا إدخال بعض 
البيانات الخاصة بالتطبيق مثل عنوان التطبيق »وصف له»ء آخر التعديلات على التطبيق (في حالة تعديل تطبيق 
منشور مسبقا)» نوع التطبيق وتصنيفه. 
التطبيق وعدد مرات تنزيله. 
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Your Registration te the Android Market is approved! 


Yau can hoa upload and publish sofware 10 lhe Aridrold Matket 


Upload an Application 


Upload assets 


Application .apk file com dummies andrmid sılentnodetaggle (49k) [Upload نا‎ 
Silamt Mode Toggle 


Yersion: 1.0 
Lacalized to: default 


This apk requests Û permniosions that wsert will he warmed about 


Screenshols aM O n~ Screenshots: 
02 320 x 8ك‎ or 480~ : 54h 
24 bil PINIG or JPEG [no alpha) 
Ful bleed, na border in att 
Landscape thumbnails ara croppod 


Replace this imagza | dels 


عل | حنقنما 2اا معقائرة 8 


Promotional Graphic Promo Graphics 


opting 18Jw x 12h 
@ 24 bit PNG ot JPEG دض‎ alpha) 
Ful bleed, no botder in att 


شكل 10.9: الصفحة التي يتم من خلالها رفع ملف التطبيق وملحقاته. 


5 . 


رك الكلية الجامعية للعلوم التطبيقية 
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